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. Revision C documents support of the Mail/VE gateway to map X.400 protocol to 
RFC822; a domain-wide directory for looking up addresses on remote hosts, notification 
of users (with an active job) of incoming mail, and the administrator's capability to 
delete and display letters in any mailbox. This revision obsoletes all previous editions. 


The ADMINISTER_MAIL utility provides some new subcommands: CHANGE _ 
DISTRIBUTION _LIST, CREATE __DISTRIBUTION _LIST, DEFINE _DEFAULT_ 
GATEWAY_ADDRESS, DELETE _DISTRIBUTION _LIST, DELETE _LETTER, 
DISPLAY_DEFAULT_GATEWAY_ADDRESS, DISPLAY_DISTRIBUTION _LIST, LIST_ 
MAIL, RETAIN _LETTER, and SELECT_LETTER. Its new mailbox and distribution 
list subutility subcommands are ADD_ADDRESS, ADD_PERMISSION, DELETE _ 
ADDRESS, DELETE _PERMISSION, DISPLAY_ADDRESS_LIST, DISPLAY _. . 
PERMISSIONS, END _CHANGE _DISTRIBUTION _LIST, END _CREATE _ 
DISTRIBUTION _LIST, and SET_ATTRIBUTES. It also supports the following new 
functions: $ANY_MAIL, $DEFAULT_MAILBOX, $DISTRIBUTION _LIST_ATTRIBUTE, 
$IDENTITY, $LETTER, $LETTER_ATTRIBUTE, $LETTER_LIST, $MAILBOX, 
$MAILBOX _ATTRIBUTE, $MAILVE_USERS, $0OWNED_DISTRIBUTION _LISTS, and 
S$OWNED _MAILBOXES. 


The following are new Mail/VE maintenance commands: COMBINE _UPDATE _ 
LETTERS, GENERATE _ADDRESS_UPDATES, GENERATE _REMOTE _UPDATES, 
INSTALL __MAIL_GATEWAY, SEND_ADDRESS_UPDATES, and UPDATE_REMOTE _ 
ADDRESSES. ACTIVATE _MAIL_GATEWAY and DEACTIVATE _MAIL_GATEWAY are 
also described with the Mail/VE maintenance commands. 
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About This Manual 


This manual documents installation and maintenance procedures for Mail/VE Version 2 
which runs on the CONTROL DATA® Network Operating System/Virtual Environment 
(NOS/VE). 


Mail/VE Version 2 is a multihost electronic mail system that conforms: to the 
internationally accepted standards described in the 1984 CCITT X.400 Recommendations ~ 
on Message Handling Systems. 


Audience 


This manual provides information for the system administrator responsible for 
installing, configuring, and maintaining Mail/VE. In addition, the manual provides 
information for the system administrator responsible for managing the NOS/VE user 
validations that control access to Mail/VE. To use this manual, you should have a 
working knowledge of the NOS/VE System Command Language (SCL) as described in 
the NOS/VE System Usage manual. 


Mail/VE Manuals 


Mail/VE is supported by two manuals. This manual describes Mail/VE administration 
activities: installation, configuration, and maintenance. 


The Mail/VE Usage manual describes how to read, write, and send letters using either 

screen or line mode. To use the Mail/VE Usage manual, you should be familiar with 

NOS/VE concepts as presented in the Introduction to NOS/VE manual. 

Conventions 

The following conventions are used in this manual: 

Boldface In a command format description, names and required parameters 
are in boldface type. 


Italics In a command format description, optional parameters are in 
italic type. 


Numbers All numbers are decimal unless otherwise noted. 


Examples Examples of user entries and computer responses are shown in a 
font that resembles computer output. 


Terminology This revision uses the term host instead of system and the term 
mail system instead of mail service. 
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Submitting Comments 


There is a comment sheet at the back of this manual. You can use it to give us your 
opinion of the manual's usability, to suggest specific improvements, and to report 
errors. Mail your comments to: 


Control Data 

Technical Publications ARH219 
4201 North Lexington Avenue 
St. Paul, Minnesota 55126-6198 


Please indicate whether you would like a response. 


If you have access to SOLVER, the Control Data online facility for reporting problems, 
you can use it to submit comments about the manual. When entering your comments, 
use MV2 as the product identifier: Include the name and publication number of the 
manual. 


If you have questions about the packaging and/or distribution of a printed manual, 
write to: 


Control Data 

Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103-2495 


or call (612) 292-2101. If you are a Control Data employee, call (612) 292-2100. 


CYBER Software Support Hotline 


Control Data's CYBER Software Support maintains a hotline to assist you if you have 
trouble using our products. If you need help not provided in the documentation, or find 
the product does not perform as described, call us at one of the following numbers. A 

support analyst will work with you. 


From the USA and Canada: (800) 345-9903 


From other countries: (612) 851-4131 
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Overview of Mail/VE | | | 


Mail/VE Version 2 is a multihost electronic mail system that conforms to the 
internationally accepted standards described in the 1984 CCITT X.400 Recommendations 
on Message Handling Systems. 


In conforming with the X.400 Recommendations, Mail/VE Version 2 utilities, 
commands, subcommands, and parameters have names that refer to terms defined in 
the recommendations. 


For readers unfamiliar with X.400 terminology, this chapter presents a brief overview 
of concepts and terms necessary for performing Mail/VE administration activities. The 
rest of this manual describes Mail/VE administration activities: 


@ Chapter 2 describes installation and configuration tasks: 


- Planning Mail/VE installations 

- Installing Mail/VE 

— Defining Mail/VE administrators 
~ Creating organizations and routes 
— Creating mailboxes for users 


In addition, it provides some procedures and examples for contig nsne: multihost 
networks. — 


e@ Chapter 3 describes how to install and maintain a Mail/VE gateway. 


@ Chapter 4 describes Mail/VE maintenance tasks: 


— Backing up and restoring Mail/VE directory files 
~ Editing a file of update subcommands 

— Converting Mail/VE Version 1 directory files 

- Maintaining a domain-wide directory 


This chapter also documents the maintenance commands and subcommands. 


e@ Chapter 5 provides reference information on the SD MINISTER _MAIL utility, and 
its subcommands and functions. 
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Mail/VE and the X.400 Recommendations 


Mail/VE and the X.400 Recommendations 


This section describes the Mail/VE implementation of X.400 Aadvesses and message 
transfer agents (MTAs). - 


Mail/VE Addresses 


In Mail/VE, each user is identified by a unique address in an address directory. To 
transfer messages in a worldwide electronic mail system, all Mail/VE systems provide 
the same hierarchy of X.400 address attributes: 


@ Global address attributes 


@ Local address attributes 


Global Address Attributes 


The global address attributes, also called interdomain attributes, are registered names 
for the following: 


@® Country 


Worldwide, each country registers a unique country code to identify itself. The 
country code of the United Kingdom is UK; the country code of the United States 
of America is US, and so on. 


e@ Administrative domain 


Within each country, a designated authority sbaeians the names of the 
administrative domains (also called administrative management domains). The 
administrative domain, in turn, has the authority to register the names of private 
domains. 


In countries that have a national telephone service, such as the United Kingdom, 
that service usually acts as the only administrative domain and has the authority 
to register the names of private domains. 


In countries that have competitive telephone services, such as the United States of 
America, the competitive telephone service will probably result in the existence of 
several administrative domains. 


e Private domain 


A private domain (also called a private management domain) can be a corporation 
or any other group that wants to manage a private domain of mail users. For 
example, Control Data Corporation could register a private domain name of CDC. 


A private domain can be registered with more than one administrative domain in 
any number of countries. 


In addition, a private domain need not be registered with any administrative 
domain. By mutual agreement, private domains can choose to be directly connected 
with one another. 
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Mail/VE and the X.400 Recommendations 


Local Address Attributes 


The. local address attributes, also called the intradomain attributes, identify 
organizations within an administrative or private domain: 


® Organization name 
® Organization units 
@ Personal name 


The administrative or private domain registers the names of organizations, which can 
consist of from one to four units. For example, Control Data, as a private domain, 
could register the organization name ARH for its Arden Hills Operations and the name 
SVO for its Silicon Valley Operation. Host names or departmental names could be 
assigned as organization units. 


A personal name is the unique name for a mailbox within a domain and organization. 
A distribution list name is a unique name for a list of addresses within a domain and 
organization. 


X.400 Message Transfer Agents (MTAs) 


The software that delivers mail to mailboxes and routes it from one mail system to 
another is called the message transfer agent (MTA). The MTA is analogous to a post 
office. That is, the MTA serves a group of mailboxes in the same manner as a post 
office serves a group of post office boxes. 


When you install Mail/VE on a host, you assign an MTA name to that Mail/VE 
installation. 
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MaiV/VE Components 


Mail/VE Components 


The Mail/VE product includes the following components: 


Component Description 


EMAIL utility Provides the user interface to Mail/VE Version 2. 
an EMAIL is documented in the Mail/VE Version 2 
Usage manual. 


ADMINISTER_MAIL utility | Provides subcommands and functions for Mail/VE 
administration tasks. For reference information on 
utility usage, see chapter 5. Before accessing this 
utility, a user's MAILVE_ADMINISTRATION 
validation must be set to ANALYST, SYSTEM, or 
FAMILY. For information on Mail/VE validations, refer 
to the next chapter. 


Mail/VE maintenance Provides commands and utilities for maintaining 

command library Mail/VE. The commands and utilities are described in 
chapter 4. Before accessing the maintenance library, a 
user's MAILVE_ADMINISTRATION validation must 
be set to ANALYST. For information on Mail/VE 
validations, refer to the next chapter. 


Mail/VE directory files Provides directories of all mailboxes and distribution 
lists in the mail system. For more information on 
Mail/VE directory files including domain-wide directory 
files, see chapter 4. 


Mail/VE gateway Supports the exchange of mail between Mail/VE and 
other mail systems on BITNet and Internet networks. 
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Mail/VE Installation and Configuration 2 


This chapter provides step-by-step instructions for performing the following tasks: 


@ Planning Mail/VE installations 

e Installing Mail/VE 

@ Creating Mail/VE administrators 

@ Defining organizations and routes 

@ Creating mailboxes for users 

It then supplies more detailed procedures and examples for configuring multihost 
networks: 

@ Configuring a mail network using NOS/VE hosts 


Configuring a mail network using NOS/VE and other X.400 hosts 


This chapter also provides a brief summary of ongoing maintenance tasks. 
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Planning Mail/VE Installations . 


Planning Mail/VE Installations 


Before beginning a Mail/VE installation, you should prepare for the tasks required 
during installation and configuration of Mail/VE by doing the following: 


@ Outline the installation and configuration steps 
e Anticipate INSTALL_MAIL requirements 


@ Plan for application interdependencies 


Installation and Configuration Overview 


The basic Mail/VE installation and configuration steps apply to all Mail/VE 
configurations: 


e A NOS/VE host 
@ Multihost NOS/VE networks 


® Multihost networks with at least one NOS/VE host and one or more other X.400 
hosts 


= @ Single-host or multihost networks connected to BITNet, Internet, or another RFC822 
mail system. 


Execute these basic steps only after reviewing the applicable sections. 
1. Review the planning material. 
2. Install Mail/VE using the INSTALL_MAIL command. 


3. If either QTF or XTF is required, install the application in accordance with the 
information in the planning section. 


4. Activate Mail/VE using the ACTIVATE MAILVE command. 
5. Create at least one Mail/VE administrator. 


6. Define routes and organizations using the CREATE_ROUTE and CREATE _ 
ORGANIZATION subcommands of the ADMINISTER_MAIL utility. (You may omit 
this step on a Mail/VE configuration consisting of a single NOS/VE host.) 


7. Create user mailboxes, if needed. 


8. Install Mail/VE gateway, if needed. For installation and maintenance information, 
see chapter 3. 


The following sections contain information about performing most of these steps. The 


sample configurations at the end of this chapter illustrate the steps and provide 
additional detail for specific configurations. 
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Planning Mail/VE Installations 


Anticipating INSTALL MAIL Requirements 


The INSTALL_MAIL command requires that you specify the country code, 
administrative domain, message transfer agent (MTA) name, and (optionally) private 
domain with which the installation of Mail/VE is associated. Table 2-1 explains how to 
select appropriate values for these parameters. 


Table 2-1. INSTALL_MAIL Parameters 


Parameter Value 
MTA name 


Administrative 
domain 


Private domain 


Country code 
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- Explanation 


Specify the MTA name selected for this Mail/VE system on the 
MESSAGE __TRANSFER_AGENT parameter. 


e@ Specify the name as a I- through 12-character string of 
alphabetic and numeric characters. 


@ Specify a unique name for each Mail/VE system within the 
interconnected hosts. 


Control Data recommends that you specify MTA as the first 
three characters in the MTA name. 


Specify the administrative domain with which this Mail/VE | 
installation is associated on the ADMINISTRATIVE _DOMAIN 
parameter. Administrative domains provide telecommunication 
services. In the United States, Telenet, AT&T, Western Union, 
MCI, and others offer administrative domain services. 


e If this Mail/VE installation is not associated with an 
administrative domain, enter a single space as the value for 
the administrative domain. 


eo If the installation is associated with more than one. 
administrative domain, select one and use it as the value of 
the ADMINISTRATIVE_DOMAIN parameter. 


Specify the private domain with which this Mail/VE installation 
is associated on the PRIVATE _ DOMAIN parameter. If a private 
domain is not specified, a Mail/VE network is classified as an 
administrative domain. 


When installing Mail/VE, determine which set of hosts makes up 
your private domain and then use the same private domain 
name for each mail system within the group. Perhaps in the 
future, administrative domain authorities in each country va 
allot private domain names. 


Select an appropriate country code from the list of countries and 
their associated codes in appendix C. Enter this code on the 
COUNTRY parameter. 
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Planning Mail/VE Installations 


Planning for Application Interdependencies 


To transfer mail successfully between hosts, you must install the Queue File Transfer 
Facility (QTF) and possibly the X.400 Transfer Facility (XTF), depending upon the - 


, configuration. 

: Application Installation Guidelines 

: QTF If your mail network includes several interconnected NOS/VE 

: hosts, use QTF to transfer mail between the hosts. 
Install QTF/QTFS (Queue File Transfer Facility/Queue File 
Transfer Facility Server):on each of the hosts. Refer to the 
NOS/VE Network Management manual for additional 
information about installing and activating QTF/QTFS. 

: XTF If your mail network includes one or more X.400 hosts other 


. than NOS/VE, use XTF to transfer mail between one or more of 
the NOS/VE hosts and the other X.400 hosts. (XTF is a 
separately priced Control Data product.) Use QTF to transfer . 
mail between the interconnected NOS/VE hosts. 


In multihost networks with NOS/VE (at least one) and other 
X.400 (at least one) hosts, installation of XTF requires entry of 
the INSTALL_X400_TRANSFER_ FACILITY (INSXTF) . 
command. The value of its MESSAGE _TRANSFER_AGENT 
parameter must be the same as the value on the MESSAGE_ 
TRANSFER _AGENT parameter of the INSTALL_MAIL 
command. 


Install QTF/QTFS on each of the interconnected NOS/VE hosts. 
. Install XTF on at least one of the NOS/VE hosts. 
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Installing Mail/VE 


Installing Mail/VE 


The NOS/VE Installation Handbook describes how to run the INSTALL_SOFTWARE 
command. After the INSTALL_SOFTWARE command has been executed from the 
system console, the Mail/VE Version 2 command library and binaries are available in 
the $SYSTEM.MAILVE _V2 catalog. You can now install Mail/VE from the system 
console. 


If Mail/VE Version 2 has been previously installed, you should attempt to reinstall it 
only when you believe users will not be accessing Mail/VE. Before beginning the 
following procedure, enter the DEACTIVATE_MAILVE command to ensure the Mail/VE 
server is deactivated. 


1. Add the maintenance command library to the command list: 


/create_command_list_entry .. 
.. /entry=$system.mailve_v2.maintenance.command_1ibrary 


2. Execute the INSTALL_MAIL procedure to initialize the Mail/VE directory files and 
installation table file. 


/install_mail message_transfer_agent=‘mtaname’ oe 
../private_domain=’privatedomain’ . 
../administrat ive_domain=’administrativedomain’ . 
. ./country=’ code’ 


For additional information on INSTALL_MAIL, see the Anticipating INSTALL_ 
MAIL Requirements earlier in this chapter, and the command description in 
chapter 3. 


3. Activate the Mail/VE server: 
/activate_mailve job_class=siteclass1 


This command initiates the Mail/VE message transfer agent as a system batch. By 
default, this job runs in the default batch job class of your NOS/VE system. If your 
default batch job class has a low priority, use the JOB_CLASS parameter to select 
a different job class for the message transfer agent. 


You can add this command to the $SYSTEM.PROLOGS_AND_. 
EPILOGS.NETWORK _ACTIVATION _EPILOG so that Mail/VE is available when 
the network is activated at every déadstart. For a description of the ACTIVATE _ 
MAILVE command, see Mail/VE Maintenance Commands in this chapter. For 
information on system prolog and epilog files, see the NOS/VE System Performance 
and Maintenance manual, Volume 2. 
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Creating Mail/VE Administrators 


The NOS/VE ADMINISTER_VALIDATIONS utility controls Mail/VE validations 
including the creation of Mail/VE administrators. Mail/VE administrators perform 
administrative tasks using the ADMINISTER_MAIL utility and Mail/VE maintenance 
commands. You must create at least one Mail/VE administrator on each system. Only a 
NOS/VE system or family administrator (that is, a user whose validation includes the 
SYSTEM _ADMINISTRATION or FAMILY_ADMINISTRATION capability) can manage 

| validations. In addition to being properly validated, Mail/VE administrators need 

= permission to access files related to Mail/VE operations. 


Mail/VE Validation Fields 


To create a Mail/VE administrator, you use the MAILVE_ADMINISTRATION field of 
the NOS/VE ADMINISTER_VALIDATIONS utility. MAILVE_ ADMINISTRATION is one 
of four validation fields that control the usage of Mail/VE Version 2. 


NOS/VE Validation Field Description - 


MAILVE _ADMINISTRATION Controls access to the ADMINISTER _MAIL 
utility and Mail/VE maintenance commands. 
The following subsection describes the 
available access levels. 


MAILVE _DISTRIBUTION _LIST_LIMIT Controls the number of distribution lists 
that a user can have. 


MAILVE _ MAILBOX _ LIMIT Controls the number of mailboxes that a 
user can have. 


MAILVE _RETENTION _ LIMIT Specifies the maximum amount of time that 
a user's letters are retained. 


MAILVE _ADMINISTRATION Access Levels 
: MAILVE_ADMINISTRATION validation supports five access levels for a NOS/VE user: 


Access Level Description 

ANALYST Authorizes use of EMAIL, ADMINISTER_MAIL,; and all 
: Mail/VE maintenance commands. 
SYSTEM Authorizes use of EMAIL and ADMINISTER_MAIL. 
FAMILY Authorizes use of EMAIL and ADMINISTER_MAIL 


subcommands to create and change mailboxes for users of a 
specific family. 


: USER Authorizes use of EMAIL, including the subcommands to create 
: and maintain mailboxes for one's own user name. 


| NONE _ Prevents use of EMAIL until a Mail/VE administrator creates a 
: mailbox for the user. This access level prohibits the user from 
executing the EMAIL subcommands to create a mailbox for the 
user's user name. 
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Changing Validations 


Using the NOS/VE ADMINISTER_VALIDATIONS utility, the NOS/VE administrator 
can change these validations in two ways: 


@ To change validations for a specific user, the administrator enters the CREATE _ 
USER or CHANGE _USER subcommand (as appropriate). 


For example, specifying the following while in the CHANGE_USER 
subcommand makes the user a Mail/VE administrator with an access level of 
ANALYST. 


CHAU/change_mailve_administration value=analyst 


© To change the default values that apply to all users of a family, the administrator 
enters the appropriate subcommand of the MANAGE_USER_FIELDS subcommand 
as shown in these two examples: 


Entering the following while in the MANAGE_USER_FIELDS subcommand 
allows users to have a maximum of 4 mailboxes. 


MANUF/change_limit_field . 
MANUF. ./field=mailve_mailbox_limit .. 
MANUF . ./default_value=4 


Entering the following while in the MANAGE_USER_FIELDS subcommand 
allows users to create their own mailboxes. 


MANUF/change_name_field . 

MANUF. ./field=mailve_administration .. 
MANUF. ./delete_default_names=all .. 
MANUF . ./add_defau]t_names=user 


Installing Permissions 


The Mail/VE administrator must be able to edit and manage the MANAGE_MAIL_ 
DIRECTORY backup files as well as access other Mail/VE files. Entering the following 
NOS/VE CREATE _CATALOG_PERMIT command establishes the necessary catalog 
permissions. 


/create_catalog_permit $system.mail_v2.mail .. 
../group=user .. 

../family=family .. 

../user=username .. . 

. ./access_modes=(all cycle contro!) 


In this example, family and username are the family and user names of the Mail/VE 
administrator. 
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Defining Organizations and Routes 


Mail/VE uses organizations and routes to locate mailboxes and distribution lists in a 
multihost environment. For single host environments, organizations can be defined, but 
are not necessary. You use the CREATE_ORGANIZATION and CREATE _ROUTE 
subcommands of the ADMINISTER_MAIL utility to define these organizations and 

. routes. 


= The MESSAGE_TRANSFER_AGENT parameter on the INSTALL_MAIL command 
= entered during installation identifies your Mail/VE system. The TITLE parameter on 
the various MANAGE_MAIL_DIRECTORY and ADMINISTER_MAIL commands and 
: subcommands refers to specific Mail/VE systems. In order for your mail to be routed 
= properly, the TITLE parameters you specify on the CREATE_ORGANIZATION and 
= CREATE_ROUTE subcommands must identify the appropriate Mail/VE systems. 


Defining Organizations 


To successfully transfer mail to all locations in a domain, all organizations in a domain 
must be defined on each host in that domain. 


Definition 


An organization is identified by an organization name and/or an ordered set of 
organization units. The set of organization units must be specified in ascending 
sequence from the least significant organization unit (lowest in preomeauen hierarchy) 
to the most significant. 


A Mail/VE installation may serve a number of organizations, but an organization may 
be served by only one Mail/VE installation. In other words, the organization definition 
(composed of organization name and/or an ordered set of organization units) cannot 

= span more than one NOS/VE host. (More than one organization can be installed on a 
: host.) 


In the following example, the organizations 1 and 2 are on different hosts. 


Organization Organization Name | Organization Unit(s) 
1 Marketing (Accounting, Minneapolis, Midwest) 
2 Marketing (Accounting,Seattle, Northwest) 


Since the organizations are located on different hosts, the organization name, 
marketing, spans the hosts. All users who are part of organization 1 are on the same 
host, and all users of organization 2 are on a different host. (It is possible to define 
two organizations on the same host. If organizations 1 and 2 were on the same host, 
then all users with the organization name, marketing, would be on the same host.) 


Before any user can use an organization definition for a mailbox or distribution list, a 
Mail/VE administrator must issue a CREATE_ORGANIZATION subcommand spene 
that organization definition. 


2-8 Mail/VE Version 2 Administration - , 60464515 C 


Defining Organizations and Routes 


Procedure 


To define an organization on a host, use the CREATE_ORGANIZATION subcommand 
of the ADMINISTER _MAIL utility: 


1. Log in to the host with a Mail/VE administrator user name. Then, start the 
ADMINISTER _MAIL utility: 


/administer_mail 
Admm/ 


2. For each organization on the host, use the CREATE_ORGANIZATION subcommand 
to define the organization: include an organization name and/or from one to four 
organization units. This subcommand associates the organization with an MTA name 
for intradomain routing. 


For example, to define an organization with the name Marketing and three 
hierarchical units called Accounting, Seattle, and Northwest, and to associate it 
with MTAYELLOW, enter: 


Admm/create_organization .. 

Admm. . /organizat ion_units=(’accounting’,’seattle’,’northwest’) . 
Admm. ./organization_name=’marketing’ .. 

Admn. ./title=“mtayel low’ 

Admm/ 


NOTE 


The order in which you list the organization units is significant. The host preserves 
the order, and you must maintain that order in all subsequent references to the 
units. For more information on the CREATE ORGANIZATION subcommand, refer 
to chapter 5. 


3. Stop the utility by entering the following subcommand: 


Admn/end_administer_mai1 
/ 


60464515 C Mail/VE Installation and Configuration 2-9 


Defining Organizations and Routes 


Defining Routes 


When you installed Mail/VE, the installation procedure defined an initial route entry 
for the MTA installed on this host. 


For each additional host in the network, define a route entry using the CREATE _ 
ROUTE subcommand of the ADMINISTER_MAIL utility. The value for the 
TRANSFER_SERVICE parameter is either QTF or XTF and the DESTINATION _ 
TYPE parameter is always MVE. 


For example, if a Mail/VE multihost environment consisted of three hosts with the 
MTA names MTAYELLOW, MTAGREEN, and MTAPINK, the following routes should 
be defined. In this example, the Mail/VE installation is in the CDC private domain in 
the United States (US), and it is not associated with an administrative domain. 


Because all the hosts in this example reside in the same country and private domain, 
Mail/VE uses these routes and the organization names and/or organization units that 
senders specify for the recipients. Mail/VE matches the title associated with the 
organization selected by a sender to a title associated with a route and then uses that 
route to deliver the mail. 


@® On host YELLOW, routes must be added for hosts PINK and GREEN: 


Admm/create_route . 
Admm../title=’mtapink’ .. 
Admm../country=’us’ .. 

Admm. ./administrative_domain=’ ’ .. 
Admn. ./private_domain=’cdc’ .. 
Admmn. ./transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admm. ./transfer_tit le=pink 


Admm/create_route .. 
Admm../title=’mtagreen’ .. 

Admm. ./country=’us’ .. 

Admm. ./administrative_domain=’ ’ .. 
Admm../private_domain=’cdc’ .. 
Adm. ./transfer_service=qtf .. 
Admm../dest ination_type=mve .. 
Admm. ./transfer_tit le=green 
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@ On host GREEN, routes must be created for hosts YELLOW and PINK: 


Admm/create_route .. 
Admn../title=’mtayellow’ .. 
Admm. ./country=’us’ 

Admm. ./administrative_domain=’ ’ 
Admn. ./private_domain=’ cdc’ 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admm. ./transfer_tit le=yel low 


Admm/create_route .. 

Admm. ./tit le=’mtapink’ 

Admm. ./country=’us’ 

Admm. ./administrative_domain=’ ’ 
Admm. ./private_domain=’ cdc’ 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admn. ./transfer_tit le=pink 


@ On host PINK, routes must be created for hosts YELLOW and GREEN: 


Admm/create_route .. 

Admn. ./tit le=’mtayel low’ 

Admm. ./country=’us’ 

Admm. ./administrative_domain=’ ’ 
Admn. ./private_domain=’cdc’ 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admm. ./transfer_tit le=yel low 


Admm/create_route .. 

Admm. ./title=’mtagreen’ 

Admm. ./country=’us’ 

Admm. ./administrative_domain=’ ’ 
Admn. ./private_domain=’ cdc’ 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admm. ./transfer_tit le=green 
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Creating Mailboxes for Users 


_Mail/VE automatically registers users in the user directory at the time mailboxes are - 
created for the user. Depending upon how you set the Mail/VE validation default, 
either the administrator or users create mailboxes. 


User-Created Mailboxes 


If you want the users at your site to be able to create and change mailboxes for their 
own use, change the default MAILVE ADMINISTRATION level to USER. Only users 
with NOS/VE SYSTEM _ADMINISTRATION or FAMILY_ADMINISTRATION capability 
can change this validation. 


If the default for the MAILVE_ADMINISTRATION validation is USER, users are 
automatically registered when they create their mailboxes. 


Administrator-Created Mailboxes 


You must create a mailbox for a user if that user's MAILVE_ADMINISTRATION 
validation is NONE. That is, a user is denied access to EMAIL until the Mail/VE 
administrator creates the mailbox. 


The following steps describe how you create user mailboxes. 
1. Start the ADMINISTER_MAIL utility: 


/administer_mail 
Admm/ 


2. Enter a CREATE_MAILBOX subcommand for each user for whom you need to 


create a mailbox. For example, to create a mailbox for user USER_1 of family 
SALES, enter: 


Admm/create_mai 1box 

Crem/select_user 

Crem. ./user=user 1 

Crem. ./family=sales 

Crem/set_attribute .. 

Crem. ./personal_name=’Frank Smith’ .. 

Crem. ./organizat ion_unit=(’accounting’,’seattle’,’northwest’) .. 
Crem. ./organizat ion_name=’market ing’ 

Crem/end_create_mai 1box 

Admm/ 


3. Stop the utility by entering the following subcommand: 


Admm/end_administer_mai1 
/ 
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Configuring a Mail Network Using NOS/VE Hosts 


This section contains a general procedure for configuring a mail network using 
NOS/VE hosts, a detailed example, and discussion of configuration interrelationships. 


General Configuration Procedure: Using NOS/VE Hosts 


The following procedure describes how you configure a mail network using NOS/VE 
hosts. 


1. Verify that you have the following information available for your hosts. 


@ MTA name 

@ Administrative domain 

@® Private domain 

@ Country code (see appendix C) 
© Host name 


2. Install Mail/VE. 
For more installation information, see Installing Mail/VE in this chapter. Also see 
chapter 4 for a description of the INSTALL_MAIL command. 

3. Install QTF/QTFS. 


See Planning for Application Interdependencies in this chapter and the NOS/VE 
Network Management manual for additional information about installing and 
activating QTF/QTFS. 


4. Enter the ACTIVATE _MAILVE command. 
/activate_mailve job_class=siteclass1 
On the JOB_CLASS parameter, specify an appropriate class for your site. 


5. Create at least one Mail/VE administrator. . 
For more information, see Creating Mail/VE Administrators in this chapter. 


6. Define organizations and routes. 


For additional information, see Defining Organizations and Routes in this chapter. 
Also see the descriptions of the CREATE ORGANIZATION and CREATE_ROUTE 
subcommands in chapter 5. . 


7. Create user mailboxes, if needed. 
For more information, see Creating Mailboxes for Users in this chapter. 


If your site is installing a Mail/VE gateway to exchange mail with a BITNet or 
Internet mail system, see chapter 3 for information on installing and maintaining a 
Mail/VE gateway. 
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Example: Using NOS/VE Hosts 


Figure 2-1 shows a Mail/VE environment consisting of three NOS/VE hosts, YELLOW, 
GREEN, and PINK, interconnected by CDCNET. The MTA names assigned to Mail/VE 
on these hosts are MTAYELLOW, MTAGREEN, and MTAPINK. All three hosts are in 
the same private domain (CDC) in the United States (as shown by the county code 
US), and are not associated with an administrative domain. 


HOST GREEN HOST PINK HOST YELLOW 


MallIVE Mall/VE 
MTAGREEN MTAYELLOW 


Figure 2-1. Mail Network Example with NOS/VE Hosts 


M03718 


The following steps illustrate how some of the general configuration procedure steps 

_ apply to host YELLOW shown in figure 2-1. The steps are repeated with appropriate 
= parameter substitutions on the other two NOS/VE hosts. Enter the commands in these 
= steps from the system console. 


1. During installation of Mail/VE, MTAYELLOW is specified as the MTA name on the 
INSTALL_¥§ MAIL command. 


/install_mail message_transfer_agent=’mtayel low’ 
../private_domain=’cdc’ 
../administrative_domain=’ ’ .. 

. ./country=’us’ 


2. Install QTF/QTFS if you have not done so previously, and define these applications 
to NAM/VE as follows:. 


/manage_application_definitions 
mad/define_qtfs family_name=yel low 
mad/def ine_atf 


mad/quit 
/ 


3. Enter the ACTIVATE _MAILVE command. 
/activate_mailve job_class=siteclass1 


On the JOB_CLASS parameter, specify an appropriate class for your site. 
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4. Define the routes to the other hosts using the CREATE _ORGANIZATION and 
CREATE _ROUTE subcommands of the ADMINISTER_ MAIL utility: 


Admm/create_organization organizat ion_unit=’ yel low_group’ 
Admm. ./tit le=’mtayel low’ 


Admm/create_organization organizat ion_unit=’green_group’ 
Admm. ./title=’mtagreen’ 


Admm/create_organization organizat ion_unit=’pink_group’ 
Admn../title=’mtapink’ 


Admm/create_route tit le=’mtagreen’ 
Admm. ./country=‘us’ 

Admn. ./administrative_domain=’ ’ 
Admn. ./private_domain=‘cdc’ 
Admm../transfer_service=qtf . 
Admmn../destination_type=mve .. 
Admm. ./transfer_tit le=green 


Admm/create_route title=’mtapink’ 
Admm. ./country=‘us’ 

Admn. ./administrative_domain=’ ’ 
Admm../private_domain=’cdce’ .. 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve . 
Admm. ./transfer_t it le=pink 


Note that the titles specified on these CREATE_ORGANIZATION and CREATE _ 
ROUTE subcommands correspond to MESSAGE _TRANSFER_AGENT parameters 
supplied in INSTALL_MAIL commands. They are MTA titles/names. They identify 
the message transfer agents (MTAs) that handle mail for the associated 
organizations. 


The names of the organization units in this example are derived from the host 
names. Sometimes, departmental units or other names are used. 
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Configuration Interrelationships 
As indicated by the direction of the arrows, figure 2-2 shows a user on YELLOW 


' sending mail to a user on PINK, in the same domain. The figure highlights the 
, correspondence between various command parameters for hosts YELLOW and PINK. 


SYSTEM YELLOW SYSTEM PINK 


Port ions Mail/VE Mai1/VE QTF Mai1/VE Mai1/VE 
of x.400 CREO CRER DEFINE_QTFS CREO - INSM 


Address 


---------------- >ORGANIZAT ION_NAME 
w--------------- >ORGANIZATION_UNIT 
wo-------------- >TITLE----->MESSAGE_TRANSFER_AGENT 
TRANSFER SERVICE=QTF 
TRANSFER_TITLE------- !-~ >FAMILY_NAME 


Figure 2-2. YELLOW User Sending Mail to PINK User 


On YELLOW, the user specifies the destination X.400 mail address, the relevant 
portions of which are shaded. These portions of the X.400 address (organization name 
and organization unit) are associated with an MTA name through the CREATE _ 
ORGANIZATION and CREATE _ROUTE subcommands. The MTA name identifies 


"= MTAPINK on host PINK as the one to receive the mail. The CREATE_ROUTE 


command indicates that MTAPINK is reached via QTF. 


: Mail/VE on PINK receives the mail and examines the X.400 address. Using the values 
: of parameters specified on the CREATE_ORGANIZATION and INSTALL_MAIL . 

= commands and saved in the route and organization tables, Mail/VE determines that the 
® mail is destined for itself and distributes the mail to the proper user. 


In this figure, parameters associated by arrows must have identical values. For 
example, the following parameters must have the same value (mtapink in this 
_ example). 


: Parameter Command or Subcommand System 
| TITLE | | CREATE _ORGANIZATION YELLOW 
| TITLE CREATE _ROUTE - YELLOW 
| TITLE CREATE _ORGANIZATION PINK 


: MESSAGE _TRANSFER_AGENT. INSTALL_MAIL PINK 


Likewise, the following parameters must have the same value (pink in this example). 


Parameter Command or Subcommand System 
| TRANSFER _TITLE CREATE _ROUTE YELLOW 
| FAMILY_NAME DEFINE _QTFS PINK 
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Configuring a Mail Network Using NOS/VE and Other 
X.400 Systems 


This section contains a general procedure for configuring a mail network using 
NOS/VE and other X.400 hosts. The procedure is followed by a detailed example and 
discussion of configuration interrelationships. 


General Configuration Procedure: Using NOS/VE and Other X.400 
Systems 


The following procedure describes how you configure a mail network using NOS/VE 
and other X.400 hosts. 


1. Verify that you have the following information available for your hosts. 


@ MTA name 

Administrative domain 
Private domain 

Country code (see appendix C) 
Host name 


2. Install Mail/VE. 


For more installation information, see Installing Mail/VE in this chapter. Also see 
chapter 4 for a description of the INSTALL_ MAIL command. 


3. Install QTF/QTFS and XTF. 
See Planning for Application Interdependencies in this chapter. 


NOTE 


It is very important that the INSTALL_X400 _TRANSFER _ FACILITY command is 
executed before you define the routes. . 


4. Define OSI addresses. 


a. Register the addresses of other X.400 hosts (non-NOS/VE hosts) using the 
ADD _OSI_ADDRESS command. 


You can add this command to the $SYSTEM.PROLOGS_AND_ 
EPILOGS.NETWORK _ACTIVATION _EPILOG so that OSI addresses of the other 
X.400 hosts (non-NOS/VE hosts) are available when the network is activated at 
every deadstart. For information on system prolog and epilog files, see the 
NOS/VE System Performance and Maintenance manual, Volume 2. Also see the 
description of the ADD_OSI_ADDRESS command in the NOS/VE Network 
Management Usage manual. 


b. Specify the ADD_NON _CDCNET_ADDRESS_PREFIX command in the 
configuration file of each DI along the path to a non-NOS/VE host. For more 
configuration information, see the CDCNET Configuration Guide. 
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NOTE 

To perform X.400 transfers using XTF, each DI on a path from XTF to a 
non-NOS/VE host must support the OSI protocol stack. Use the SUPPORTED _ 
STACKS parameter of the CHANGE_PROTOCOL_STACK _SUPPORT command 


to establish OSI as a supported protocol stack for each DI running 
CDCNET 1.4.2: 


/change_protocol_stack_support supported_stacks=al 1 
or 


/change_protocol_stack_support supported_stacks=osi 


See the CDCNET Network Operations and Analysis manual for more 
information on setting or changing protocol stacks. 


5. Enter the ACTIVATE _MAILVE command. 
/activate_mailve job_class=siteclass1 
On the JOB_CLASS parameter, specify an appropriate class for your site. 


6. Create at least one Mail/VE administrator. 
For more information, see Creating Mail/VE Administrators in this chapter. 


7. Create a permit for the Mail/VE administrator to the catalog containing the XTF 
configuration file. Enter the following at the system console: 


/create_catalog_permit .. 

. ./catalog=$system.xtf .. 
../group=user .. 
../family_name=family . 
../user=username . 
../access_mode=(all,cycle,control) .. 
. ./share_mode=none 


In this example, family and username are the family and user name of the Mail/VE 
administrator. 
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8. Define organizations and routes. 


For additional information, see Defining Organizations and Routes in this chapter. 
Also see the descriptions of the CREATE ORGANIZATION and CREATE _ROUTE 
subcommands in chapter 5. 


9. Create user mailboxes, if needed. 
For more information, see Creating Mailboxes for Users in this chapter. 


10. Activate XTF from the system console by entering ACTIVATE _XTF. This command 
is on OSF$BUILTIN _LIBRARY. 


You can add this command to the $SYSTEM.PROLOGS_AND _ 
EPILOGS.NETWORK _ACTIVATION _EPILOG so that XTF is available when the 
network is activated at every deadstart. For information on system prolog and 
epilog files, see the NOS/VE System Performance and Maintenance manual, Volume 
2. Also see the description of the ACTIVATE —XTF command in the NOS/VE 
Network Management Usage manual. 


If your site is installing a Mail/VE gateway to exchange mail with a BITNet or 
Internet mail system, see chapter 3 for IDAOTMatOn on installing and maintaining a 
Mail/VE gateway. 


Example: Using NOS/VE and Other X.400 Hosts 


Figure 2-3 shows a mail environment consisting of four hosts: 


System Description | MTA Name(s) 
NOS/VE _ The YELLOW, GREEN, and PINK systems are . MTAYELLOW 


interconnected by CDCNET. Each host has a 
Mail/VE mail system. The three systems are in MTAGREEN 
the same private domain (CDC) in the United 


States (US), and are not associated with an MTAPINK 
administrative domain. (The domains are not 
shown in the figure.) 

Other X.400 The XYZ host has a different mail system (not XYZMTA 


system Mail/VE). Its system is connected to MTAYELLOW 
by Ethernet and CDCNET. This system is in the 
private domain (XYZ) in the United States (US), 
and is associated with an administrative domain 
(abemail). (The domains are not shown in the 
figure.) 
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HOST GREEN HOST PINK HOST YELLOW 


Mail/VE Mall/VE MallVE XTF 
MTAGREEN MTAPINK MTAYELLOW] |MTAYELLOW 


Figure 2-3. Mail Network Example with NOS/VE and Other X.400 Hosts 


In this example, the three Mail/VE mail systems (MTAYELLOW, MTAGREEN, and 
MTAPINK) are in the same domain, and the XYZMTA mail system is in a different 
domain. XTF is installed on only one of the NOS/VE hosts, YELLOW. The Mail/VE 
mail service on YELLOW acts as a mail relay between the Mail/VE mail Byelems on 
hosts GREEN and PINK and the mail system on host XYZ. 


_ The following subsections show how some of the general configuration procedure steps 
= apply to the three NOS/VE hosts shown in figure 2-3. Enter the commands in these 
# steps from the system console. 


Setting up Host YELLOW 
To configure host YELLOW, perform the following steps: 


1. Install Mail/VE. Specify MTAYELLOW as the MTA name on the INSTALL_MAIL 
command. In this example, The country code is the US, and the private domain is 
CDC. MTAYELLOW is not associated with an administrative domain. 


/install_mail .. 

. ./message_transfer_agent=‘’mtayel low’ 
../private domain=’cdc’ 
../administrative_domain=’ ’ .. 

. ./country=’us’ 
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2. Install QTF/QTFS if you have not done so previously, and define these applications 
to NAM/VE as follows:. 


/manage_application_definitions 
mad/define_qtfs fami ly_name=yel low 
mad/def ine_qtf 

mad/quit 

/ 


3. Install XTF. Specify MTAYELLOW as the MTA name on the INSTALL_X400_ 
TRANSFER _FACILITY command. 


jieeaN ab Ostwans fer taetiay bes 
../message_transfer_agent=mtayellow .. 
. ./password=’cdcpw’ 


4. Define OSI addresses for host XYZ. 


a. Define the OSI address for XYZMTA using the ADD_OSI_ADDRESS command. 
Obtain the values for the NETWORK _ADDRESS, TRANSPORT_SELECTOR, 
and SESSION _SELECTOR parameters from someone familiar with the values 
required by host XYZ. 


/add_osi_address title=’ xyzmta’ 

. ./network_address=‘’nnnnnn’ 

../transport_selector=‘tttttttt’ .. 

../session_selector=’ssss’ 
../title_identifier=xyzmta 


b. Specify the ADD_NON_CDCNET_ADDRESS_PREFIX command in the 
configuration file of each DI along the path to a non-NOS/VE host. Coordinate 
the host and DI entries. 


NOTE 


To perform X.400 transfers using XTF, each DI on a path from XTF to XYZMTA 
must support the OSI pretocol stack. Use the SUPPORTED_STACKS parameter of 
the CHANGE _PROTOCOL_STACK _SUPPORT command to establish OSI as a 
supported protocol stack for each DI running CDCNET 1.4.2.: 
/change_protocol_stack_support supported_stacks=al1 


or 


/change_protocol_stack_support supported_stacks=osi 


5. Enter the ACTIVATE _MAILVE command. 
/activate_mailve job_class=siteclass1 
On the JOB_CLASS parameter, specify an appropriate class for your site. 


6. Create at least one Mail/VE administrator. 
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7. Create a permit for the Mail/VE administrator to the catalog containing the XTF 
configuration file. Enter the following at the system console: 


/create_catalog_permit catalog=$system.xtf .. 
../group=user .. 

../family_name=family .. 

../user=username .. 
../access_mode=(all,cycle,control) .. 

. ./share_mode=none 


In this example, family and username are the family and user name of the Mail/VE 
administrator. 


8. Define the routes to the other hosts using the CREATE_ORGANIZATION and 
~ CREATE_ROUTE subcommands of the ADMINISTER_MAIL utility: | 


Admm/create_organization organizat ion_unit=’yel]low_group’ 
Admm. ./tit le=’mtayel low’ 


Admm/create_organization organizat ion_unit=’green_group’ 
Admn. ./t it le=’mtagreen’ 


Admm/create_organization organization_unit=’pink_group’ .. 
Admm../title=’mtapink’ — 


Admm/create_route title=’mtagreen’ .. 
Admm../country=’us’ .. 
Admm. ./administrative_domain=’ ’ 
Admn../private_domain=’cdc’ .. 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admn. ./transfer_t it le=green 


Admm/create_route title=‘mtapink’ .. 
Admm. ./country=’us’ .. 

Admn. ./administrative_domain=’ ’ 
Admm../private_domain=’cdc’ .. 
Admm../transfer_service=qtf .. 

Admm. ./destination_type=mve .. 

Admm. ./transfer_tit le=pink 


Admm/create_route title=’xyzmta’ .. 
Admm. ./country=’us’ .. 

Admn../private domain=’xyz2’ .. 

Admm. ./administrat ive_domain=’abcmai1’ 
Admm../transfer_service=xtf .. 

Admm. ./password=‘ xyzpw’ 


9. Create user mailboxes, if needed. 


10. Activate XTF from the system console by entering the ACTIVATE_XTF command. 
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Setting up Host PINK 
To configure host PINK, perform the following steps: 


1. Install Mail/VE. Specify MTAPINK as the MTA name on the INSTALL_MAIL 
command. The country code, administrative domain, and private domain are the 
same as on MTAYELLOW since both MTA names are in the same domain. 


/install_mail message _transfer_agent=’mtapink’ .. 
../private domain=’cdc’ .. 
../administrative_domain=’ ’ .. 

../country=’us’ 


2. Install QTF/QTFS. 
/manage_applicat ion_definitions 
mad/define_qtfs fami ly_name=pink 
mad/def ine_atf 


mad/quit 
/ 


3. XTF is not installed on this host. 
4. Enter the ACTIVATE _MAILVE.command. 
/activate_mailve job_class=siteclass1 
On the JOB_CLASS parameter, specify an appropriate class for your site. 


5. Create at least one Mail/VE administrator. 
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6. Define the routes to the other hosts using the CREATE ORGANIZATION and 
CREATE ROUTE subcommands of the ADMINISTER_MAIL utility: 


' Admm/create_organization organizat ion_unit=’pink_group’ 
Admm. ./tit le=’mtapink’ 


Admm/create_organization organizat ion_unit=’yel ]low_group’ 
Admm. ./tit le=’mtayel low’ 


Admm/create_organization organizat ion_unit=’green_group’ 
Admm. ./tit le=’mtagreen’ 


Admm/create_route tit le=’mtayel low’ 
Admm../country=’us’ .. 

Admm. ./administrative_domain=’ ’ 
Admm. ./private_domain=’cdc’ 
Admm../transfer_service=qtf .. 
Admm../destination_type=mve .. 
Admm. ./transfer_tit]le=yel low 


Admm/create_route title=’ xyzmta’ 

Admm. ./country=’us’ 

Admn. ./administrative_domain=’ abcmai 1’ 
Admn../private domain=’ xyz’ 

Admm. ./transfer_service=qtf .. 
Admm../destination_type=mve .. 

Admmn. ./transfer_tit le=yel low 


Admm/create_route title=’mtagreen’ 
Admm../country=’us’ .. 

Admn. ./administrative_domain=’ ’ 
Admm. ./private_domain=’cdc’ 
Admm../transfer_service=qtf .. 
Admm. ./destination_type=mve .. 
Admn. ./transfer_tit le=green 


7. Create user mailboxes, if needed. 
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Setting up Host GREEN 
To configure host GREEN, perform the following steps: 


1. Install Mail/VE. Specify MTAGREEN as the MTA name on the INSTALL_MAIL 
command. The country code, administrative domain, and private domain are the 
same as on MTAYELLOW since both MTA names are in the same domain. 


/install_mail message_transfer_agent=’mtagreen’ .. 
../private_domain=‘’cdc’ . 
../administrative_domain=’ ’ .. 

../country=’us’ 


2. Install QTF/QTFS. 
/manage_application_definitions 
mad/define_qtfs fami ly_name=green 
mad/def ine_qtf 


mad/quit 
/ 


3. XTF is not installed on this host. 
4. Enter the ACTIVATE _MAILVE command. 
/activate_mailve job_class=siteclass1 
On the JOB_CLASS parameter, specify an appropriate class for your site. 


5. Create at least one Mail/VE administrator. 
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6. Define the routes to the other hosts using the CREATE ORGANIZATION and 
CREATE _ROUTE subcommands of the ADMINISTER_MAIL utility: 


Admm/create_organization organizat ion_unit=’green_group’ 
Admm. ./tit le=’mtagreen’ 


Admn/create_organization organizat ion_unit=’ pink_group’ 
Admn. ./title=’mtapink’ 


Admm/create_organization organizat ion_unit=’ yel low_group’ 
Admm. ./tit le=’mtayel low’ 


Admm/create_route title=’mtapink’ 
Admm. ./country=‘us’ 

Admn. ./administrative_domain=’ ’ 
Admn. ./private_domain=’cdc’ 
Admm../transfer_service=aqtf . 
Admm../destination_type=mve . 
Admm. ./transfer_t it le=pink 


Admm/create_route tit le=’mtayel low’ 
Admn. ./country=’us’ 

Admm. ./administrative_domain=’ ’ 
Admm. ./private_domain=’cdc’ 
Admm../transfer_service=qtf .. 
Admn. ./dest ination_type=mve .. 
Admn. ./transfer_t it le=yel low 


Admm/create_route title=’ xyzmta’ 
Admm../country=’us’ .. 

Admm. ./private_domain=’ xyz’ 

Admm. ./administrative_domain=’abcmai1’ 
Admm../transfer_service=qtf .. 

Admm. ./destination_type=mve .. 

Admn. ./transfer_tit le=yel low 


7. Create user mailboxes, if needed. 
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Configuration Interrelationships 


As indicated by the direction of the arrows, figure 2-4 shows a user on YELLOW 
sending mail to a user on XYZ, in a different domain. The figure highlights the 
correspondence between various command parameters for hosts YELLOW and XYZ. 


SYSTEM YELLOW SYSTEM XYZ 


Portions Mail/VE ; Mail/VE XTF NAM/VE 
of X.400 CRER INSM INSXTF ADDOS 1A 
Address 


wa----=- >MTA Name (xyzmta) 
‘ >MTA Password 


Actas >Remote MTA Name (mtayel low) 
Saseeese >Remote MTA Password 


Figure 2-4. YELLOW User Sending Mail to XYZ User 


On YELLOW, the user specifies the destination X.400 mail address, the relevant 
portions of which are shaded. These portions of the X.400 address (country and private 
domain) are associated with an MTA name (and corresponding password) through the 
CREATE_ROUTE subcommand. That MTA name identifies XYZMTA on host XYZ as 
the one to receive the mail. — 


The mail system on XYZ receives tne mail and distributes it to the proper user. The 
remote MTA name on host XYZ identifies MTAYELLOW as a host from which it 
accepts mail. 


In this figure, parameters associated by arrows must have identical values. For | 
example, the following parameters must have the same value. (In this example, the 
value of these parameters is xyzmta.) 


Parameter Command or Subcommand System 
TITLE CREATE _ROUTE YELLOW 
TITLE ADD _OSI_ADDRESS YELLOW 
(MTA Name) (host dependent) XYZ 
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As indicated by the direction of the arrows, figure 2-5 shows a user on XYZ sending 
mail to a user on YELLOW, in a different domain. The figure highlights the 
correspondence between various command parameters for hosts XYZ and YELLOW. 


SYSTEM XY2 SYSTEM YELLOW 


Portions XTF Mail/VE Mail/VE 
of x.400 INSXTF INSM CRER 
Address 


GQUNERY oon errr nnn rrr nn nn nnn nnn nnn nnn | conn nn ener nnnnnnen nnn >COUNTRY 
PRAVATS Rahat ----~----- ene nnn nnn n nn nnn a | enn n nnn nnn ne nnw enn nn >PRIVATE_DOMAIN 
...>Remote MTA Name~-(mtayel low)--------------- 
...>*Remote MTA Password----~-------~ 9 en 
MTA Name~(xyzmta) ----- omen n nnn nnn nnn nner | eon n nnn nnn nnn nnn nnn nme conan nnnn anne nnn >TITLE 
MTA PaSSwOPd~--- nnn nnn nnn nn nnn nnn nnn nnn [nnn nnn nnn nnn rn nnn nnn nn nace nnn nn ncn nn >PASSWORD 
' TRANSFER_SERV ICE=XTF 


Figure 2-5. XYZ User Sending Mail to YELLOW User 


On XYZ, the user specifies the destination X.400 mail address, the relevant portions of 
which are shaded. These portions of the X.400 address (country, and private domain) 
are mapped into the remote MTA name (and corresponding password) as indicated by 
the dotted arrows. That remote MTA name identifies MTAYELLOW on host YELLOW 
as the one to receive the mail. 


Mail/VE on YELLOW receives the mail and examines the X.400 address. Based on the 
parameters on the INSTALL_MAIL command, it determines that the mail is destined 
for host YELLOW and distributes the mail to the proper user. The TITLE parameter 
on the CREATE_ROUTE subcommand identifies XYZMTA as a host from which it 
accepts mail. 


In this figure, parameters associated by arrows must have identical values. For 
example, the following parameters must have the same.value. (In this example, the 
value of these parameters is mtayellow.) 


Parameter Command System 

MESSAGE _TRANSFER _AGENT INSTALL _X400_TRANSFER _ YELLOW 
FACILITY 

MESSAGE _ TRANSFER _AGENT INSTALL_MAIL YELLOW 


(Remote MTA Name) (host dependent) ; XYZ 
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As indicated by the direction of the arrows, figure 2-6 shows a user on PINK sending 
mail to a user on XYZ, in a different domain. The figure highlights the correspondence 
between various command parameters for hosts PINK, YELLOW, and XYZ. 


SYSTEM PINK SYSTEM YELLOW SYSTEM XYZ 


Portions Mail/VE QTF Mail/VE Mail/VE XTF NAM/VE 
of X.400 CRER DEFINE_QTFS INSM CRER INSXTF ADDOSIA 
Address 


Gountry-------- >COUNTRY---~--~=~ }--------2-=----------- >COUNTRY 


some er scene cre ne ene- >PRIVATE_DOMA IN 
Ti WEspSseeecens ->Remote MTA Name (mtayel tow) 
TRANSFER_SERVICE ->Remote MTA Password 
=QTF ->MTA Name (xyzmta) 
->MTA Password 


TRANSFER_TITLE-- | ->FAMILY_NAME 


Figure 2-6. PINK User Sending Mail to XYZ User 


On PINK, the user specifies the destination X.400 mail address, the relevant portions 
of which are shaded. These portions of the X.400 address (country and private domain) 
are associated with an MTA name through the CREATE_ROUTE subcommand. That 
MTA name identifies MTAYELLOW on host YELLOW as the one to receive the mail. 


Mail/VE on YELLOW receives the mail and examines the X.400 address. Based on the 
CREATE _ROUTE subcommand, it determines that the mail must be sent to XYZMTA 
on host XYZ. 


The mail system on XYZ receives the mail and distributes it to the proper user. The 
remote MTA name on host XYZ identifies MTAYELLOW as a host from which it 
accepts mail. 


In this figure, parameters associated by arrows must have identical values. For 
example, the following parameters must have the same value (mtayellow in this 
example). 


Parameter Command or Subcommand System 

TITLE CREATE _ROUTE PINK 

MESSAGE _ TRANSFER _AGENT INSTALL MAIL - YELLOW 

MESSAGE _ TRANSFER _AGENT INSTALL __X400_TRANSFER _ YELLOW 
FACILITY 

(Remote MTA Name) (host dependent) XYZ 


Likewise, the following parameters must have the same value (yellow in this example): 


Parameter Command or Subcommand System 
TRANSFER _TITLE CREATE _ROUTE PINK 
FAMILY_NAME DEFINE _QTFS YELLOW 
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As indicated by the direction of the arrows, figure 2-7 shows a user on XYZ sending 
mail to a user on PINK, in a different domain. The figure highlights the 
correspondence between various command parameters for hosts XYZ, YELLOW, and 
PINK. 


SYSTEM XY2 SYSTEM YELLOW SYSTEM PINK 


Port ions XTF Mail/VE Mail/VE Mail/VE Maii/VE 
of xX. 400 INSXTF INSM CRER CREO CRER 
Address 


QTF Mail/VE Mail/VE 
DEFINE. CREO INSM 
QTFS 


weennaaane >COUNTRY 
Sieiicewee >PRIVATE_DOMAIN >PRIVATE DOMAIN-- 


qesssoqSstserssaes >COUNTRY 
SPSS tee esse >PRIVATE DOMAIN 
mo mee er enese manne mene en ennn >ORGANIZATION_UNI T--~=------- |----=----->ORGANIZATION_UNIT 
-->MTA---->MTA (mtayellow) | 

.-.>Remote MTA Password- | -->PASSWORD 

MTA Name-(xyzmta) n= [rotor rrr nnn >TITLE 

MTA PasSword----- nn monn anno tne n renner >PASSWORD 

TRANSFER_SERV ICE=XTF 


H 
' 
J 
' 
I 
nanan nn nnn nena nnn anna n= >ORGANIZATION_NAME----------- | ----~~---->QRGANIZATION_NAME 
I 
1 
t 
t 
1 


eoere nme -- >TITLE-->MTA (mtapink) 
TRANSFER_SERVICE} : 

=QTF : H 
TRANSFER_TITLE-- | ->FAMILY_NAME 


Figure 2-7. XYZ User Sending Mail to PINK User 


Qn XYZ, the user specifies the destination X.400 mail address, the relevant portions of 
which are shaded. These portions of the X.400 address (country, private domain, 
organization name, and organization unit) are mapped into the remote MTA name (and 
corresponding password) as indicated by the dotted arrow shafts. That remote MTA 
name identifies MTAYELLOW on host YELLOW as the one to receive the mail. 


Mail/VE on YELLOW receives the mail. The TITLE parameter on the first CREATE_ 
ROUTE subcommand in figure 2-7 identifies XYZMTA as a host from which it accepts 
mail. Mail/VE examines the X.400 address. Based on CREATE_ORGANIZATION and 
CREATE _ROUTE subcommands and the parameters cn the INSTALL_MAIL command, 
it determines that the mail must be sent to MTAPINK (on host PINK). 


Mail/VE on PINK receives the mail and examines the X.400 address. Based on the’ 
CREATE _ORGANIZATION subcommand and the parameters on the INSTALL_MAIL 
command, it determines that the mail is destined for host PINK and distributes the 
mail to the proper user. 
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In this figure, parameters associated by arrows must have identical values. For 
example, the following parameters must have the same value (mtapink in this 
example). 


Parameter Command or Subcommand System 
TITLE CREATE _ORGANIZATION YELLOW 
TITLE CREATE _ROUTE YELLOW 
TITLE CREATE _ORGANIZATION PINK 
MESSAGE _TRANSFER _AGENT INSTALL_MAIL PINK 


Likewise, the following parameters must have the same value (pink in this example). 


Parameter Command or Subcommand System 
TRANSFER _TITLE CREATE __ROUTE YELLOW 
FAMILY_NAME DEFINE _QTFS PINK 
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Maintaining Mail/VE 


: After Mail/VE is installed, you are responsible for some ongoing maintenance tasks 
* including monitoring output queue activity, repairing damaged database files, and 
accommodating terminal differences. 


Output Queue Activity 


Messages sent by users are put in the output queue with OUTPUT_DESTINATION _ 
USAGE set to MVE. Depending on the volume of messages generated at your site, you 
may need to increase the size of the output queue. See the NOS/VE System 
Performance and Maintenance Manual, Volume 1 for information on changing the size 
of the output queue. 


If a Mail/VE user attempts to send a message when the queue is full, the user receives 
an error message. When this happens in screen mode, the user can save the text of the 
letter in progress by copying $LOCAL.MVF$LETTER to a file before reentering the 
WRITE _LETTER utility or Write Letter screen. 


Active Message Transfer Agent 


Once in the output queue, messages are processed by the message transfer agent 
activated by the ACTIVATE_MAILVE command. If the message transfer agent is not 
active, messages accumulate in the output queue and can possibly fill it. Mail/VE does 
not notify users when this situation exists. 


You can remedy the situtation by executing the ACTIVATE _MAILVE command. This 
command brings the message transfer agent up and processes the output queue. 


Deferred Messages 


If a message transfer agent cannot deliver a message, it usually sends a nondelivery 
notice to the sender and discards the message. Certain circumstances cause the 
message transfer agent to defer a message by changing the OUTPUT_DEFERRED _ 
BY_USER value to YES. The following errors produce deferred messages: 


Type of Error Description 
Internal MTA server errors Related to database files 
Data errors Produced when the message transfer agent 


cannot process the message protocol 


If your site has a large number of deferred messages, it indicates a serious problem 
requiring immediate action. Contact CYBER Software Support for assistance. 


Repairing Damaged Database Files 


If a system interrupt occurs while a database file is open and job recovery does not 
= take place, the file may be damaged. You must repair a damaged file before Mail/VE 
: can open it. 


os. 
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System Database Files 


To repair a Mail/VE v2 system database file, execute the following commands from the 
system console: 


task ring=4 
copy_keyed_file i=database_file_name o=database_fiie_name.$next 
taskend 


For the variable database_file_name use the complete path name for the file. If you 
attempt to execute these commands from a catalog other than that in which the file 
resides, you must have CYCLE permission to the file. 


If the data within the file is incomplete, you can delete and recreate the file. If your 
site uses MANAGE_MAIL_DATABASE to maintain a backup of the system database, 
you can use that utility to restore the database. 


User Database Files 


If the damaged file is a user database file (SUSER.MVF$ELECTRONIC_MAIL_ 
DATABASE), the user must enter the following Mail/VE command after the system 
prompt: 


compress_mai!l_database 


This command performs a COPY_KEYED_FILE of the database to a new cycle. The 
user must execute the command outside of Mail/VE, because it requires exclusive 
access to the user's database. 


If the data within the database file is incomplete, the user can request that the file be 
restored from an archived copy. If the user is not concerned about the letter content, 
the user can delete the database file and Mail/VE creates a new one the next time the 
user enters EMAIL. To delete the user database, the user must have ring 4 privilege 
or create a file permission granting access mode of CYCLE and CONTROL to a user 
who does. 


Terminal Differences: VT220 


Sometimes, you may need to make modifications to accommedate terminal differences. 
For example when you are using Mail/VE, the VT220 terminal definition produces two 
overlapping menu rows of function keys at the bottom of the screen. To correct this 
problem, modify the definition by adding the following lines: 


source_code_utility 
use_library b=$system.cybil.osf$program_interface r=$nul1 
edit_deck d=csm$dec_vt220 m=emai1_mod 
locate_text t=’" programmable function key input information’ 
replace_text t=’f10% nt=""f10’ 
quit 
expand_deck d=csm$dec_vt220 c=$local.tdu_source 
define_terminal i=$local.tdu_source b=tdu_binary 
set_program_attributes al=tdu_binary 
quit 
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= This modification blots out the F10 function key on your screen, making room for the 
: remaining keys. To modify the master TDU (you must have READ and CYCLE 

= permission for the libraries referenced), perform the following commands from user 

= $SYSTEM: 


create_object_library 
add_library 1=$system.tdu.terminal_definitions 
combine_moduie m=tdu_binary 
generate_library 1l=$system.tdu.terminal_definitions.$next 
quit 


_ NOTE 


Any site changes to the files $S)YSTEM.TDU.TERMINAL__DEFINITIONS or 

= $SYSTEM.OSF$COMMAND_LIBRARY are eliminated by the installation of corrections 
* to the subproducts TDU and NOSVE_INITIAL_LOAD, respectively. To determine 

= whether you need to reapply site modifications, refer to the documentation 

= accompanying the correction. The ring attributes of files $SYSTEM.TDU.TERMINAL_ 
= DEFINITIONS and $SYSTEM.OSF$COMMAND_LIBRARY should be (3,13,13). 
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A Mail/VE gateway supports the exchange of mail between Mail/VE and other mail 
systems on BITNet and Internet networks. A gateway performs two basic functions: 


© Converts messages between the X.400 protocols used by Mail/VE and the RFC822 
protocols used in the BITNet and Internet networks. 


-@ Routes mail between a Mail/VE network and the BITNet and Internet networks. 


While the Mail/VE gateway can also support the relay of mail between BITNet and 
Internet networks, this chapter focuses on the tasks that the Mail/VE administrator 
' performs to support the basic functions. The chapter describes how you install and 
maintain a Mail/VE gateway. 


Mail/VE Administrator Tasks 


As Mail/VE administrator, you are responsible for installing and maintaining the 
Mail/VE gateway. Your MAILVE_ADMINISTRATION validation must be set to 
ANALYST, and you must have permission to access the $SYSTEM.MAILVE _V2 catalog 
with an ACCESS_MODE of (ALL,CYCLE,CONTROL). Then you can i the 
following Mail/VE gateway installation and maintenance tasks: 


® Install the Mail/VE gateway using the INSTALL_MAIL_GATEWAY command 


© Define the Mail/VE gateway and the networks it represents to Mail/VE using the 
CREATE _ORGANIZATION and CREATE_ROUTE subcommands of the 
ADMINISTER_MAIL utility 


© Obtain and update the DOMAIN_NAMES_FILE! 


In addition to the general task descriptions in this section, this chapter provides the 
following to help you perform the tasks: 


© Mail/VE gateway installation procedure 
® Reference descriptions of the DOMAIN _NAMES_FILE entries 


@ Routing examples 


1. DOMAIN_NAMES_FILE is the default name for the file containing domain names. It is used throughout 
this manual to specify this file. If you wish, you can specify a different name for the file on the DOMAIN _ 
NAMES_FILE parameter when you issue the INSTALL_MAIL_GATEWAY. command. . 
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Installing a Mail/VE Gateway 


: The Mail/VE gateway must have address information for each of the X.400, Internet, 
: and BITNet networks connected to it. During the installation of the Mail/VE gateway, 
: you supply this information through the INSTALL_MAIL_GATEWAY command. 


: The INSTALL_MAIL_GATEWAY command poner the: ee address information 
: for the networks: 


| X40 Address __—=—BITNet Address Internet Address 


* Private domain Mailer name Internet domain name 
anes - , _, (subdomain.subdomain..) 
# Administration domain | Node name 


= Country Default NTF station name 
: Organization units 

Organization name 
: The command also defines: 


: © The name (title) of the gateway. Other mail systems use this title when routing 
# mail to the gateway with QTF and XTF. 


: @ The name of the file that will contain the domain names (by default, this is 
: $SYSTEM.MAILVE _V2.DOMAIN _NAMES _ FILE). . 


: The procedure for installing the Mail/VE gateway is described later in this chapter. 


Creating Gateway Routes and Organizations 


You define the gateway and its address with the CREATE _ROUTE and CREATE_ 
ORGANIZATION subcommands in the ADMINISTER_MAIL utility. 


Subcommand Description 
CREATE _ROUTE Identifies the gateway as a Mail/VE gateway 


and associates its name with a specific 
country, administrative domain, and private 
domain. You specify the same value for the 
TITLE: parameter of the CREATE ROUTE 
subcommand and the MAIL_GATEWAY_ 
NAME parameter of the INSTALL_MAIL_ 
GATEWAY command. 


: CREATE _ORGANIZATION 1. Associates an organization name and/or 
: units with the gateway. 


2. Can be used to define X.400 addresses 
for BITNet and Internet destinations. 
You must add :x400. entries to the 
DOMAIN _NAMES _FILE to translate 
these X.400 addresses to their 
corresponding BITNet or Internet 
addresses. 
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Maintaining a DOMAIN _NAMES _ FILE 


The Mail/VE gateway uses a DOMAIN _NAMES_FILE to translate addresses and route 
mail through the networks. How you create and maintain your DOMAIN _NAMES _ 
FILE depends upon which mail systems you want to exchange mail with Mail/VE.? 
There are three possibilities: 


e BITNet mail systems 
@ Internet mail systems 
@® BITNet and Internet mail systems 


As Mail/VE administrator, you must supply the information that the Mail/VE gateway 
uses to make routing decisions and address mail to users of other mail systems in the 
connected networks. To do this, you create entries for the mail systems exchanging 
mail in a DOMAIN NAMES _FILE. 


The information you put in the DOMAIN_NAMES_FILE enables your Mail/VE users 
to send mail to BITNet and Internet users. They can address the mail in either of two 
ways: 


@ X.400 addresses (which the Mail/VE gateway converts to Internet or BITNet 
addresses via :x400. entries) 


© RFC822 addresses 
name@RFC822_ADDRESS 
For more information on addressing mail, see the Mail/VE Version 2 Usage manual. 


For descriptions of the types of entries used in the DOMAIN_NAMES_FILE, see 
DOMAIN _NAMES_FILE Entries. 


2. For installation details, see the Installation Procedure for Mail/VE Gateway section. 
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Installation Procedure for Mail/VE Gateway 
This procedure contains three parts: | 
@ Setting up a DOMAIN _NAMES_FILE 

@ Installing a Mail/VE gateway 

e Adding the Mail/VE gateway address to other NOS/VE hosts 


Figure 3-1 shows the addition of a Mail/VE gateway to the example (figure 2-3) of the 
mail network with NOS/VE and other X.400 hosts. The gateway communicates with 
BITNet and Internet mail systems. The gateway and related additions are unshaded. 


MallVE 
Gateway 
MGGREEN [| 


Internat 


WORKS1 WORKS2 
TETHYS.AHSE.CDC.COM} }HARRY.UDEV.COC.COM 


BITNet 


Figure 3-1. Mail Network Example with Mail/VE Gateway 
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Setting Up a DOMAIN _NAMES _ FILE 


The following procedure outlines the steps you take in setting up a DOMAIN _ 
NAMES _FILE. How you proceed depends upon whether you want to communicate with 
BITNet mail systems, Internet mail systems, or both. 


Establishing BITNet Communications 


If you are planning to exchange mail with BITNet mail systems, take the following 
steps and refer to the BITNet portions of figure 3-1. 


1. Create three entries in $SYSTEM.MAILVE _V2.DOMAIN _NAMES_FILE for an 
organization (at least one) that will communicate with the BITNet mail systems. 
The following examples illustrate how you create the :nick., :x400., and :internet. 
entries for this organization. 


a. The :nick. entry tells the Mail/VE gateway which route to take to reach the 
destination. 


:nick.CDCARH .. 
:route.du=local,ou="bitnet’ ,on=’vearn’ ,pd=’cdc’ ,c=’us’ .. 
X.400 


b. The :x400. entry translates an X.400 address into an RFC822 address. 


:x400 .ou=’bitnet’ ,on=’vearh’ ,pd=’cdc’ ,c=’us’ .. 
: internet .CDCARH 


c. The :internet. entry translates an RFC822 address into an X.400 address. 


:internet.CDCARH .. 
:X400 .ou=’bitnet’ ,on=’vearh’ ,pd=’cdc’ ,c=’us’ 
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2. Create :nick., :x400., and :internet. entries for each X.400 organization recognized 
by your Mail/VE system. The following entries are for the figure 3-1 organizations 
defined in chapter 2. 


:nick.GREEN-GROUP.CDC.COM .. 
:route.du=1local,ou=’green-group’ ,pd=’cdc’ ,c="us’ 
X.400 

:X400.GREEN-GROUP.CDC.COM .. 

: internet .ou=’green-group’ ,pd=’cdc’ ,c=’us’ 

: internet .GREEN-GROUP.CDC.COM .. 

:X400,ou=’green-group’ ,pd=’cdc’ ,c=’us’ 


:nick.YELLOW-GROUP.CDC.COM .. 
:route.du=local,ou=’yel low-group’ ,pd=’cdc’ ,c=’us’ 
X.400 

:>X400.YELLOW-GROUP.CDC.COM .. 

: internet .ou=’yel low-group’ ,pd=’cdc’ ,c=’us’ 

: internet . YELLOW-GROUP .CDC.COM .. 

:x400,0u=’ yel low-group’ ,pd=’cdc’ ,c=’us’ 


:nick.PINK~GROUP .CDC.COM .. 
:route.du=local,ou=’pink-group’ ,pd=’cdc’ ,c=’us’ 
X.400 . 

:>X400.PINK-GROUP.CDC.COM .. 

: internet .ou=’pink-group’ ,pd=’cdc’ ,c=’us’ 

: internet .PINK-GROUP.CDC.COM .. 

:X400,ou=’pink-group’ ,pd=’cdc’ ,c=’us’ 


:nick.XYZ.COM .. 
:route.du=local, pd=’ xyz’ ,ad=’abcmail’ ,c=’us’ 
X.400 

:X400.XYZ.COM .. 

: internet .pd=’ xyz’ ,ad=’abcemail’ ,c=’us’ 

:internet .XYZ.COM .. 

:X400, pd=’ xyz’ ,ad=’abcmail’,c=’us’ 


3. Create :nick., :x400., and :internet. entries for the Mail/VE gateway. The domain 
name of the :nick. entry for the Mail/VE gateway must match the value of the 

. INTERNET_DOMAIN NAME parameter specified on the INSTALL_MAIL_ 
GATEWAY command. 


:nick.GREEN-GW.CDC.COM .. 


:route.du=local 
: X.400 
: :x400.ou=’green-gw’ ,pd=’cdc’ ,c=’us’ 
: : internet .GREEN-GW.CDC.COM 


: internet .GREEN-GwW.CDC.COM .. 
:x400 .ou=’green-gw’ ,pd=’cdc’ ,c="us’ 
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4. Add an entry which defines where to send rejected rejection notices. 
:nick.*<>* .. 
:route.du=local ,pn=’postmaster’ ,ou=’green_group’ ,pn=’cdc’,c=’us’ .. 
X.400 
5. Add an entry which defines the default routing action. 
:nick. *DEFAULT* :route.du=ntf BSMTP 


6. Perform the procedures in Installing the Mail/VE Gateway section. When you have 
installed and activated the gateway, continue with the following step. 


7. Obtain copies of the DOMAIN NAMES and XMAILER NAMES files from the 
BITNet Network Information Center by sending requests to listservebitnic: (If 
your site is an established BITNet site, you may already have these files on your 
NOS/VE host.) 


a. To request a copy of the DOMAIN NAMES file, send the following message: 


send DOMAIN NAMES 


To request a copy of the XMAILER NAMES file, send the following message: 
send XMAILER NAMES 


The BITNet Network Information Center replies by sending you messages 
containing these files. 


b. Take the following steps and copy the messages that you receive to the NOS/VE 
files listed below: 


Messages Received NOS/VE File 
Domain names $SYSTEM.MAILVE_V2.DOMAIN _NAMES _FILE.$EOI 


Xmailer names $LOCAL.XMAILER_NAMES _ FILE 


1) Copy the domain names message to the end of your existing DOMAIN _ 
NAMES _FILE. 


2) Reformat and append XMAILER_NAMES_FILE to DOMAIN _NAMES _FILE 
by entering the following: 


/create_command_list_entry .. 
../entry=$system.mailve_v2.maintenance.command_library 
/format_domain_names .. > ; 
../local_bitnet_node_name=nodename . . 
../input=$local.xmailer_names_file .. 

. ./output=$system.mailve_v2.domain_names_file.$eoi 
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Establishing Internet Communications 


In order for the Mail/VE gateway to communicate with Internet mail systems, SMTP 
must be installed on the same host as the gateway. You should verify that SMTP is 
installed on the host you are working with before proceeding with the Mail/VE gateway 
installation. For SMTP information, see the CDCNET TCP/IP Applications manual. 


Creating Entries 


_If you are installing the Mail/VE gateway to exchange mail with Internet mail 
systems, take the following steps and refer to. the Internet portions of figure 3-1: 


1. Create a DOMAIN_NAMES_FILE which contains your local entries. For each local 
organization and route recognized by your Mail/VE system, add three entries to the 
DOMAIN _NAMES _FILE. The following examples illustrate how you create the 
inick., :x400., and :internet. entries for X.400 addresses. In this procedure, the 
X.400 addresses are your Mail/VE addresses. 


a. The :nick. entry tells the Mail/VE gateway which route to take to reach the 
destination. 


:nick.GREEN_GROUP.CDC.COM .. 
:route.du=local ,ou=’green_group’ ,pd=’cdc’ ,c=’us’ .. 
X.400 


b. The :x400. entry translates an X.400 address into an RFC822 address. 


:X400 .ou=’green_group’ ,pd=’cdc’ ,c=’us’ 
: internet .GREEN_GROUP .CDC .COM 


c. The :internet. entry translates an RFC822 address into an X.400 address. 


: internet .GREEN_GROUP.CDC.COM .. 
:x400.ou=’green_group’ ,pd=’cdc’ ,c=’us’ 


The following entries are for the other figure 3-1 organizations defined in chapter 2. 


:nick.YELLOW-GROUP.CDC.COM .. ; 
:route.du=local ,ou=’ yel low-group’ ,pd=’cdc’ ,c="us’ .. 
X.400 

:x400.YELLOW-GROUP.CDC.COM .. 

: internet .ou=’yel low-group’ ,pd=’cdc’ ,c=’us’ 

: internet .YELLOW-GROUP .CDC.COM .. 

:X400 ,ou=’ yel low-group’ ,pd=’cdc’ ,c=’us’” 


:mick.PINK-GROUP.CDC.COM .. 
:route.du=local ,ou=’pink-group’ ,pd=’cdc’ ,c=’us’ .. 
: x.400 
:x400.PINK-GROUP .CDC.COM .. 
: internet .ou=’pink-group’ ,pd=’cdc’ ,c=’us’ 
: internet .PINK~GROUP.CDC.COM .. 
:x400,ou=’ pink-group’ ,pd=’cdc’ ,c=’us’ 


snick.XYZ.COM .. 


:route.du=local,pd=’ xyz’ ,ad=’abcmail’,c=’us’ .. 
X.400 
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:X400.XYZ.COM .. 

: internet .pd=’ xyz’ ,ad=’abcmail’ ,c=’us’ 
: internet .XYZ.COM .. 

:x400, pd=’ xyz’ ,ad=’abcmail’ ,c=’us’ 


2. Create :nick., :x400., and :internet. entries for the Mail/VE gateway. The domain 
name of the :nick. entry for the Mail/VE gateway must match the value of the 
INTERNET_DOMAIN __NAME parameter specified on the INSTALL_MAIL_ 
GATEWAY command. 


:nick.GREEN-GW.CDC.COM .. 
:route.du=local 
X.400 

:X400.ou=’green-gw’ ,pd=’cdc’ ,c=’us’ .. 
: internet .GREEN-GW.CDC.COM 

: internet .GREEN-GW.CDC.COM .. 
:X400.ou=’green-gw’ ,pd="Ccdc’ ,c=’us’ 


3. Add an entry which defines where to send rejected rejection notices. 
:nick.*<>* .. 


:route.du=local,pn=’postmaster’ ,ou=’green_group’ ,pn=’cdc’ ,c=’us’ . 
X.400 


4. Add the following default entry to serve as a catchall for when none of the other 
entries matches an address. 


:nick. *DEFAULT*® :route.du=smtp BSMTP 


Configuring Internet Workstations 


There are two basic ways to configure workstations connected by a LAN. The easiest 
solution is to treat all workstations as an entity. To do this, you create a 
:nick.*DEFAULT* entry: 


:nick. *DEFAULT* :Poute.du=smtp BSMTP 
The other solution is to create a separate :nick. entry for each: 


~:Nick.TETHYS .AHSE .CDC .COM :route.du=smtp BSMTP 
:nick.HARRY.UDEV.CDC.COM | :route.du=smtp BSMTP 
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Establishing Both BITNet and Internet Communications 


If you are planning to exchange mail with both BITNet and Internet mail systems as 
shown in figure 3-1, take the following steps: 


1. Perform the steps in Establishing Internet Communications. 


2. Create three entries in $SYSTEM.MAILVE _V2.DOMAIN __NAMES_FILE for an 
organization (at least one) that will communicate with the BITNet mail systems. 
The following examples illustrate how you create the :nick., :x400., and :internet. 
entries for this organization. 


a. The :nick. entry tells the Mail/VE gateway which route to take to reach the 
destination. 


:nick.CDCARH .. 
:route.du=local ,ou=’bitnet’ ,on=’vearh’ ,pd=’cdc’ ,c=’us’ .. 
X.400 


b. The :x400. entry translates an X.400 address into an RFC822 address. 


:x400 .ou=’bitnet’ ,on=’vearh’ ,pd=’cdc’ ,c=’us’” .. 
: internet .CDCARH 


c. The :internet. entry translates an RFC822 address into an X.400 address. 


:internet .CDCARH . 
:X400.ou="bitnet’ ,on=’vearh’ ,pd=’cdc’ ,c=’us’ 


3. Perform the procedures in Installing the Mail/VE Gateway section. When you have 
installed and activated the gateway, continue with the following step. 


4. Obtain copies of the DOMAIN NAMES and XMAILER NAMES files from the 
BITNet Network Information Center by sending requests to listservebitnic: (If 
your site is an established BITNet site, you may already have these files on your 
NOS/VE host.) 

a. To request a copy of the DOMAIN NAMES file, send the following message: 
send DOMAIN NAMES 
To request a copy of the XMAILER NAMES file, send the following message: 
send XMAILER NAMES 7 


The BITNet Network Information Center replies by sending you messages 
containing these files. 
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b. Take the following steps and copy the messages that you receive to the NOS/VE 
files listed below: 


Messages Received NOS/VE File 
Domain names $SYSTEM.MAILVE _V2.DOMAIN _NAMES _FILE.$EOI 


Xmailer names $LOCAL.XMAILER _NAMES _FILE © 


1) Copy the domain names message to the end of your existing DOMAIN _ 
NAMES _FILE. 


2) Reformat and append XMAILER_NAMES_FILE to DOMAIN _NAMES_FILE 
by entering the following: 


/create_command_list_entry .. 

. ./entry=$system.mailve_v2.maintenance.command_library 
/format_domain_names .. 
../local_bitnet_node_name=nodename .. 
../input=$local.xmailer_names_file .. 

. /output =$system.mailve_v2.domain_names_file.$eoi 


5. Delete the following BITNet Network Information Center entries from the 
DOMAIN _NAMES _ FILE. 


:nick. .COM :mMai ler .SMTPUSER@INTERBIT BSMTP 
:nick. .EDU :mailer .SMTPUSER@INTERBIT BSMTP 
:nick. .GOV :mailer .SMTPUSER@INTERBIT BSMTP 
:nick. .MIL :mailer .SMTPUSER@INTERBIT BSMTP 
:nick. .NET :mailer .SMTPUSER@INTERBIT BSMTP 
:nick. .ORG :mailer.SMTPUSER@INTERBIT BSMTP 
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Installing the Mail/VE Gateway 


When you have completed the DOMAIN_NAMES_FILE entries, you are ready to 
install the Mail/VE gateway. 


1. Install the Mail/VE gateway on a NOS/VE host from the system console: | 
a. Add the maintenance command library to the command list: 


/create_command_list_entry .. 
../entry=$system.mailve_v2.maintenance.command_library 


b. Execute the INSTALL_MAIL_GATEWAY command. The following example uses 
the recommended naming conventions: 


/install_mail_gateway .. 
../mail_gateway_name=MGGREEN .. 

.. /private_domain=’cdc’ 
../administrative_domain=’ ’ .. 
../country="us’ 

.. /organizat ion_units=’green-gw’ 
.-/internet_domain_name=’ green-gw.cdc.com’ 
../bitnet_mailer_name=mailer .. 

. ./bitnet_node_name=cdcarh 


The following defaults are assumed in the example: 


domain_names_file=$system.mailve_v2.domain_names_file 
stat ion=automatic 


Be sure to record the parameter values that you enter since you cannot display 
them later. 


If you prefer, you can enter the command in a file and execute it. To do this, 
use your editor to create a file, enter your INSTALL_MAIL_GATEWAY 
command in the file, and then execute it with a NOS/VE INCLUDE _FILE 
command. This method preserves a record of your parameter selections and 
enables you to correct typographical errors later, if necessary. 


Control Data recommends a specific naming scheme for the following INSTALL_ 
MAIL_GATEWAY parameters. 
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Parameter Recommended Name 
MAIL __GATEWAY_NAME MG prefix and the host name: 
MGGREEN 


INTERNET DOMAIN NAME Host name with a suffix of -gw plus the domain 
in which the host resides: 


green-gw.cdc.com 


If you are using SMTP, you must also define 
the name specified for this parameter in 
$SYSTEM.TCP_IP.HOSTS as the primary name 
of the NOS/VE host. 


BITNET_MAILER_NAME Name Mail/VE uses to identify itself to other 
BITNet mail systems: 


mailer 


Control Data recommends that you register this 
name with the BITNet Network Information 
Center. 


For more information about the INSTALL_MAIL_GATEWAY command: see the . 
description in chapter 4. 


c. Define your site's BITNet node name as a local name to the Network Transfer 
Facility (NTF) on the ADD_LOCAL_NAME subcommand of the MANAGE _ 
NTF_LOCAL_NAMES utility. Specify the same name for both the REMOTE _ 
NAME and LOCAL_NAME parameters on this subcommand as you did on the 
INSTALL_MAIL_GATEWAY command for the BITNET_NODE _NAME 
parameter as shown in the following example: 


/use_ntf_utilities 

usenu/manage_nt f_local_names 

Mannin/add_local_name remote_name=cdcarh local_name=cdcarh 
Mann 1n/quit 

usenu/quit 


This BITNet node name is the name of the Mail/VE system that your site 
registered with the BITNet Network Information Center when it became part of the 
BITNet network. For a description of the MANAGE_NTF_LOCAL_NAME utility, 
see the Network Transfer Facility Usage Manual. 


2. Execute the DEFINE _DEFAULT_GATEWAY_ADDRESS subcommand. Specify the 
same values for this command as you did for the INSTALL_MAIL_GATEWAY 
command. 


/administer_mail 

admm/def ine_default_gateway_address .. 
admm. ./organization_units=’green-gw’ .. 
admn../private_domain=‘’cdc’ .. 
admm../administrative_domain=’ ’ . 
admm. ./country=’us’ 


For a description of the DEFINE_DEFAULT_GATEWAY_ADDRESS subcommand, 
see chapter 5. 
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3. Define the following organizations and routes: 
a. Define an organization and route for the Mail/VE gateway. 


admm. ./create_organization .: 
admm../title=mggreen .. 
admn. ./organizat ion_unit=’green-gw’ 


admm. ./create_route .. 
admm../title=mggreen .. 

admm. ./country=‘us’ 

admm. ./administrative_domain=’ ’ .. 
admm. ./private_domain=’cdc’ .. 
admm. ./transfer_service=local .. 
admm. ./dest inat ion_type=mg 


b. If you are establishing BITNet communications and created three entries in 
$SYSTEM.MAILVE _V2.DOMAIN _NAMES_FILE for an organization that will 
communicate with the BITNet mail systems, enter the CREATE _ 
ORGANIZATION subcommand to define that organization. 


admm../create_organization .. 
admm../title=mggreen .. 

admm. ./organization_unit="bitnet’ .. 
admm. ./organizat ion_name=’ vearh’ 


For additional information, see Defining Organizations and Routes in chapter 2. 
Also see the descriptions of the CREATE _ORGANIZATION and CREATE _ROUTE 
subcommands in chapter 5. 


4. Enter the ACTIVATE _MAIL_GATEWAY command from the system console. 
/activate_mail_gateway job_class=siteclass1 


This command establishes the Mail/VE gateway as a system job. By default, this 
job runs in the default batch job class of your system. If your default batch job 
class has a low priority, you can use the JOB_CLASS parameter to select a 
different class for the Mail/VE gateway job as illustrated by siteclass1 in this 
example. 


To verify that the Mail/VE gateway job is active, enter the following command: 
display_job_status $name(’mai lve_mg’//$mainframe(id)) 


You can add the ACTIVATE _MAIL_GATEWAY command to the 
$SYSTEM.PROLOGS _AND _EPILOGS.NETWORK _ACTIVATION _EPILOG so that 
the Mail/VE gateway is available when the network is activated at every deadstart. 
For a description of the ACTIVATE _MAIL_GATEWAY command, see Mail/VE 
Maintenance Commands in chapter 4. For information on system prolog and epilog 
files, see the NOS/VE System Performance and Maintenance manual, Volume 2. 
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Adding the Mail/VE Gateway to Other NOS/VE Hosts 


After you have installed the Mail/VE gateway on one host, perform the following steps 
on each of the other NOS/VE hosts in your network. In the network illustrated in 
figure 3-1, you perform this procedure on PINK and YELLOW after you install the 
Mail/VE gateway on GREEN. 


1. Be sure Mail/VE is installed on the host. 


2. Execute the DEFINE _DEFAULT_GATEWAY_ADDRESS subcommand. Specify the 
same values for this command as you did for the INSTALL_MAIL_GATEWAY 
command as shown in the following example: 


/administer_mai] 

admm/def ine_default_gateway_address .. 
admm. ./organization_units=’green-gw’ .. 
admm../private_domain=’cdc’ .. 
admm../administrative_domain=’ ’ . 
admm. ./country=‘us’ 


3. Define an organization and route for the Mail/VE gateway. 


admm../create_organization .. 
admm../title=mggreen .. , 
admm. ./organizat ion_unit=’green-gw’ 


admm../create_route .. 
admm../title=mggreen .. 
admm../country=’us’ .. 
admm../administrative_domain=’ ’ .. 
admm../private_domain=’cdc’ .. 
admm../transfer_service=qtf .. 
admm. ./destination_type=mg .. 
admm../transfer_tit le=green 
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DOMAIN _NAMES _FILE Entries 


A DOMAIN _NAMES_FILE contains entries that the Mail/VE gateway uses to 
translate addresses and route mail. There are four types of entries: 


Entry Description 


nick. (standard) entry Supports BITNet routing only. (It is used by the 
BITNet Network Information Center in the DOMAIN 
NAMES file maintained there.) 


:nick. (extended) entry Supports local, Internet, X.400 (for example, Mail/VE), 
and BITNet routing, including NTF and QTF options. 

:x400. (extended) entry Translates X.400 addresses into RFC822 format. 

:internet. (extended) entry Translates RFC822 addresses into X.400 format. 


Entry Format 


| ‘The standard and extended :nick. entries contain three fields as shown in this typical 


entry: 
:nick.UMASS.EDU :mailer.SMTP@UMASS BSMTP 
ee VY YY” 
domain field routing field format field 
M04283 


: The three fields (domain, routing, and format) are separated by white space. The 
domain and routing fields are structured as :keyword.value. With the exception of the 
format field, the :x400. and :internet. entries adhere to the same format as the :nick. 
entries and have a :keyword.value structure in the first two fields. All four entries 
contain lines of legible text with a case-insensitive syntax. 


snick. (Standard) Entry 


The standard :nick. entry specifies a route to a mail system identified in the domain 
field. In the following example, the Mail/VE gateway routes mail destined for the 
domain SATURN.UCC.UMASS.EDU to a mail transfer agent named SMTPUSER on a BITNet 
node named UMASS. In addition, mail destined for SATURN.UCC.UMASS.EDU is sent in 
BSMTP format. 


:nick.SATURN.UCC .UMASS . EDU :mai ler .SMTPUSER@UMASS BSMTP 


Domain Field 


What immediately follows :nick., in either a standard or extended :nick. entry, is the 
known part of a BITNet or Internet address. That is, the domain field contains the 
:nick. keyword followed by a full domain name or a domain suffix. The example 
illustrates this :keyword.value structure. 


:nick.SATURN.UCC .UMASS .EDU 
Given an address to which to deliver a message, the Mail/VE gateway searches the 


DOMAIN __NAMES _FILE sequentially for the first :nick. entry that matches the 
address or a suffix of it. 
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Subdomain Order 


The mail system stops searching for an entry when it finds a standard or extended 
nick. entry that matches at least a suffix of the address, in the subdomain order. The 
DOMAIN _NAMES_FILE is organized so that :nick. entries with more specific 
addresses appear before entries with less specific ones, as shown in the following 
example: 


:nick.SATURN.UCC .UMASS .EDU :mai ler .SATURN@UMASS BSMTP 
:nick.UCC .UMASS .EDU :mai ler .UCC@UMASS BSMTP 
:nick.UMASS .EDU :mailer .SMTP@UMASS BSMTP 
:nick. .EDU :mailer .SMTP@INTERBIT BSMTP 


Although the four entries in this example include suffixes of the same address, they 
identify different mail systems. 


® The first is the host SATURN in the University Computing Center at UMASS 
(University of Massachusetts). 


® The second is a catchall for any unlisted host at the University Computing Center. 


© The third is any department (not just the University Computing Center) at UMASS 
(University of Massachusetts). This general address applies to all of the 
departments in the university. 


® The fourth entry is any institution in the EDU domain. 


If these entries do not occur in the DOMAIN_NAMES_FILE in the exact order 
specified, Mail/VE will route some messages incorrectly. 


For example, if the order is rearranged as shown in the following example, the 
Mail/VE gateway matches messages addressed to the second :nick. entry to the first 
nick. entry. The messages are misrouted because the address of the first entry matches 
a suffix of the address in the subdomain order of the second entry and that first entry 
occurs before the more specific one. 


:nick.UCC.UMASS .EDU :mailer .UCC@UMASS BSMTP 
:nick.SATURN.UCC.UMASS .EDU :mailer .SATURN@UMASS BSMTP 
:nick.UMASS .EDU :mailer .SMTP@UMASS BSMTP 
:nick. .EDU :mailer .SMTP@INTERBIT BSMTP 


Extra Periods 


Some :nick. entries contain an extra period. When an address in the domain field 
begins with a period as does .EDU in the following entry, it indicates that the address 
is a proper suffix and only matches addresses that include additional subordinate 
subdomains. 

:nick. .EDU :mailer.SMTPUSER@INTERBIT BSMTP 


The following address does not match the preceding :nick. entry because the address 
does not include subdomains subordinate to the domain, EDU. 


bert@edu 
The next address does contain a subdomain and, therefore, matches the :nick. entry: 


bert@umass.edu 
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Routing Field 


© The routing field of a standard :nick. entry identifies the address of the mail system 
= supporting the RFC822 address in the domain field. The routing field consists of the 
# :mailer. keyword and a value equaling the user name and BITNet node name of the 
= destination mail system. 


: In the following example, the routing field identifies the BITNet name and address of 
| the mail system, UCCe@UMASS, that supports UCC .UMASS.EDU: 


:nick .UCC .UMASS . EDU :mai ler .UCC@UMASS BSMTP 


: The :mailer. keyword implicitly selects NTF as a delivery service. 


Format Field 


: The format field specifies the message format expected by the mail system receiving 
# the mail. Both the standard and extended :nick. entries use this field. The translation 
= entries, ‘internet. and :x400., do not use it. The following list shows which values 

| apply. 


Entry Format Field Value 

nick. (standard) You can-use either of the values described below in the format 
field: 
BSMTP Mail/VE gateway routes the message in a BSMTP 

’ envelope addressed to the recipient(s). 
BITNET Mail/VE gateway routes the message without a 
BSMTP envelope. 

nick. (extended) You can use any of the values described below in the format 
field: 
BSMTP Mail/VE gateway routes the message in a BSMTP 


envelope addressed to the recipient(s). 


BITNET Mail/VE gateway routes the message without a 
BSMTP envelope. 


X.400 Mail/VE gateway translates the message into 
X.400 format. 


snick. Extensions 

: The standard :nick. entries do not accommodate the routing and address translation 

= required by a gateway supporting mail exchange between Internet and X.400 networks. 
: The following extensions meet these requirements: 

: @ (extended) :nick. entry 


@ :x400. entry 


: @ internet. entry 
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nick. Entry 


The extended :nick. entry with the :route keyword instead of :mailer in the routing 
field identifies the route by which a destination domain can be reached. 


The full format of this entry follows: 


:nick.domain_name .. 
:route.du=dest ination_usage,routing_parameters .. 
format 


Field Description 


Domain Contains the :nick. keyword plus a known RFC822 domain 
name. 


Routing Contains the :route. keyword plus an output destination usage 
and, if needed, routing parameters for the destination usage. 
Table 3-1 lists the available destination usages, and table 3-2 
summarizes the NTF routing parameters. 


Format Contains one of the following: 
BITNET 
BSMTP 
X.400 


The Mail/VE gateway uses the first matching standard or extended :nick. entry to 
route mail to an RFC822 address. In other words, the gateway matches the given 
address to the domain field, and then uses the routing field (regardless of whether the 
keyword is :mailer or :route) to send the mail to the appropriate mail system. 


Default Entries 


A default entry acts as a catchall when the Mail/VE gateway cannot match an address 
to any other entry. In the following example, the gateway routes messages with 
unmatched destination addresses through NTF. 


:nick. *DEFAULT* :route.du=ntf BITNET 


Rejected Rejection Notice Entry = 


The :nick.*< >* entry identifies an X.400 mailbox which serves as a MEPOBINOEY, for 
rejection notices that cannot be delivered to their senders. 


:nick.*<>* .. 
:route.du=local,pn=’postmaster’ ,ou=’green_group’ ,pn=’cdc’ ,c=’us’ 
X.400 


SEES EL ESEE SES SSE SSS SSSE SS SSS ESS SSS STS SUS SSS SSNS SSSSSEEESSSSSSESSESSEESESSSSESEESSSESSSSSSSSSSESSESSSSSSSSSSSSESESSSSEESSSESSSSEESSESS SSIS SSSSESESSSSS SSS 
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Table 3-1. :route. Destinations for Extended :nick. Entry 
Option Description 


: ROUTE . DU=SMTP Indicates that messages are delivered using the Simple Mail 
Transport Protocol (SMTP). 


The full form of this routing field follows. BSMTP is allowed in the 
format field, but is superfluous. 


:route.du=smtp .. 
BSMTP 


:ROUTE.DU=LOCAL Indicates that the matching address identifies an X.400 destination 
to which messages are delivered using X.400 protocol. X.400 address 
information may be supplied to specify the destination in X.400 
terms. 


The full form of this routing field follows. X.400 is allowed in the 
format field, but is superfluous. 


:route.du=local,ou=(’ou1l’ , “ou2’, “ous’, ’ou4’),.. 
on=’organizat ionname’ , pd=’privatedomain’,.. 
ad=’administrationdomain’,c=’country’ .. 


X.400 
ou Specifies the list of organization units. 
on Specifies the organization name. 
pd Specifies the private domain. 
_ ad Specifies the administration domain. 
c Specifies the country code. 


(Continued) 


PESSOLLOO PHP areata eles eee al yale etree eaten te rent Mee atatatatetptetanatatetetetettatcteiatatetpiatatatatataaneranarstatatetetetel 
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Table 3-1. :route. Destinations for Extended :nick. Entry (Continued) 
Option Description 


The Mail/VE administrator can specify the X.400 address for the 
matched RFC822 domain name suffix in as much detail as desired. 
The Mail/VE gateway applies additional procedures to map the 
unmatched parts of the RFC822 domain name to the X.400 format. 


For example, if the Mail/VE gateway is matching the following 
address and :nick. entry, the unmatched part of the domain name, 
vesta, automatically is mapped to the ORGANIZATION _UNIT 
parameter. 


kej@vesta.ahse.cdc.com 


:nick.ahse.cdc.com .. 
:route.du=local ,on=’ahse’ ,pd=’cdc’ ,c=’us’ 
X.400 


:ROUTE . DU=QTF Identifies a QTF path to a mail system. For example, a QTF route 
allows you to use existing QTF and CDCNET services to exchange 
mail between Mail/VE and a NOS-resident mailer. 


The full form of this routing field follows. The parameters between - 
brackets ([..]) are optional. 


:route.du= ate: ode=out put_dest ination[,rhd=’nos pepametenss | eee 
[BSMTP}]BITNET] 


For descriptions of the routing parameters, see the applicable host 
manuals. For example, see System Commands, volume 3 of the NOS 
2 Reference Set, for a description of the MFQUEUE command ane 
the parameters accepted by the NOS routing directive. 


(Continued) 
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: Table 3-1. :route. Destinations for Extended :nick. Entry (Continued) 


Option Description 
Parameter 


ODE 


RHD 


Description 


Specifies the QTF title which is the output destination 
for the message. 


For example, if the destination is a NOS-resident 
mailer, this name must match the title registered in 
CDCNET by the NP gateway. For information on 
configuring an NP gateway, see the CDOCNET 
Commands Reference manual for descriptions of the 
DEFINE _NP_GATEWAY and ADD_GATEWAY_ 
OUTCALL_TITLE commands. 

Specifies remote host directives containing the QTF 
routing parameters. 


:ROUTE . DU=NTF Identifies BITNet mail systems that deliver mail directly to 
mailboxes without being processed by a message transfer agent. 
(They do not use the :mailer.) 


The full form of this routing field follows. The Network Transfer 
Facility (NTF) parameters between brackets ([..]) are optional. 


:route.du=ntf [,ode=node][,s=scfs][,rhd=’nje parameters’] . 
[BSMTP|BITNET] 


Parameter 


ODE 


Description 


Specifies the BITNet node name which is the output 


RHD 
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destination for the message. 


The default is the domain_name from the :nick.domain_ 
name field. 


Specifies the station name used by the Mail/VE 
gateway when routing files through NTF. 


The default is AUTOMATIC which directs NTF to use 
the AUTOMATIC STATION NAME specified at NTF 
activation via the ACTIVATE_NTF command. 


Specifies remote host directives containing NTF 
routing parameters. Enter these parameters as name 
or string values: 


Name: rhd=’ddn=dataset ’ 
String: rhd=’ddn=’’ idataset’’’ 


Table 3-2 lists the routing parameters you can use to 
send mail directly to BITNet users. These parameters 
are always sent with the mail; other NTF parameters 
are not sent unless you specify them. For more 
information about NTF parameters, see the Network 
Transfer Facility Usage Manual. 
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Table 3-2. NTF Routing Parameters 


Parameter 


DDN 


JOB 


MCL 


PGN 


PGR 


PIN 


RSU 


STN 


UID 


XWI 
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Description 


Specifies the data set name. 


The default is the name of the Mail/VE gateway registered with 
the BITNet Network Information Center. It is the value you 
specify on the BITNET_MAILER_NAME parameter of the 
INSTALL MAIL GATEWAY command. 


Specifies the hold flag. 
The default is NO. 
Specifies the job name. 


The default is the first 8 characters of the surname (last name) 
of the user sending the message. 


Specifies the message class. 
The default is M. 
Specifies the programmer's name. 


The default is the first 8 characters of the surname (last name) © 
of the user sending the message. 


Specifies the programmer's room number. 


The default is the node name of the Mail/VE system registered 
with the BITNet Network Information Center. It is the value 
you specify on the BITNET_NODE_NAME parameter of the 
INSTALL _ MAIL _GATEWAY command. 


Specifies the procedure invocation name. 


The default is the first 8 characters of the surname (last name) 
of the user sending the message. - 


Specifies the destination remote name. 


The default is the name of the user receiving the message (for 
example, sheryl of sheryi@timbuktu). 


Specifies the step name. 
The default is the keyword MAIL. 
Specifies the user name. 


The default is the name of the user sending the message (for 
example, sheryl of sheryl@timbuktu). 


Specifies the external writer. 


The default is the name of the user receiving me message (for 
example, sheryl of sheryl@timbuktu). 
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:x400. Entry 


: The :x400. entry defines a translation of X.400 (Mail/VE) addresses to RFC822 
: addresses. It is the inverse of the :internet. entry. You can use the :internet. keyword 
with any RFC822 address including BITNet and Internet addresses. 


The full format of this entry follows: 
:x400 .ou=(’oul’ , “0u2’ ,’0u3” , ’0u4’) ,on=’organizat ionname’ ,pd=’privatedomain’,.. 
ad=’administrat ivedomain’ ,c=’country’ .. 


: internet .domain_name 


Field Description 


:x400. Contains the :x400 keyword plus the X.400 (Mail/VE) address. 
ou Specifies the list of organization units. 
on Specifies the organization name. 
pd Specifies the private domain. 
ad Specifies the administration domain. 
e « Specifies the country code. 
internet. Contains the :internet. keyword plus the RFC822 domain name 


that is equivalent to the Mail/VE address given in the :x400. 
field. This address has the following format: 


subdomain.subdomain.subdomain. . 


As with :nick. entries, the Mail/VE gateway uses the first :x400. entry that matches 
part of a given Mail/VE (X.400) address to translate the address. As a result, you must 
arrange the :x.400 entries in your DOMAIN_NAMES_FILE in a most specific to most 
general order. The following example, which shows the fields of various :x400 entries, 
illustrates this order; it begins with the most specific, becomes less specific, and ends 
with the most general. 


:x400.ou=(’oul’, “ou2’, “ou3’ , “ou4’ ) ,on=’organizat ionname’ ,pd=’privatedomain’,.. 
ad=’administrat ivedomain’ ,c=’ country’ 

:x400.on=’organizat ionname’ ,pd=’privatedomain’ ,ad=’administrativedomain’,.. 
c=’country’ 

:x400 .pd=’privatedomain’ ,ad=’administrat ivedomain’ ,c=’country’ 

:x400 .ad=’administrativedomain’ ,c=’country’ 

:x400 .c=’ country’ 
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sinternet Entries 


The :internet. entry defines a translation of RFC822 addresses to X.400 addresses. It is 
the inverse of the :x400. entry. You can use the :internet. keyword with any RFC822 
address including BITNet and Internet addresses. 


The Mail/VE gateway uses this entry to assign an X.400 address to an RFC822 
(Internet or BITNet) domain name. With an equivalent :x400. entry, an :internet. entry 
allows an X.400 user to reply to mail from an RFC822 user via an X.400 address. 


The full format of this entry follows: 


:internet .domain_name .. 
:>X400.ou=(’oul’ , “0u2’ , “ou”, “ou4’) ,on=’organizat ionname’ ,pd=’privatedomain’,.. 
ad=’administrat ivedomain’ ,c=’country’ 


Field Description 


‘internet. Contains the :internet. keyword plus an RFC822 domain name. 
This address has the following format: 


subdomain.subdomain.subdomain. . 


:x400. Contains the :x400. keyword plus the X.400 (Mail/VE) address 
that is equivalent to the RFC822 domain name given in the 
domain field. 


ou Specifies the list of organization units. 
on Specifies the organization name. 

pd Specifies the private domain. 

ad Specifies the administration domain. 

c Specifies the country code. 
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Routing Examples 


The routing examples in this section are based upon a Mail/VE gateway using the 
installation information shown in figure 3-2, the DOMAIN _NAMES_FILE fragment 
shown in figure 3-3, and the organizations and routes shown in figure 3-4. 


install_mail_gateway .. 
mail_gateway_name=mgcdc .. 
country=’us’ 
administrative_domain=‘attmail’ 
private_domain=’cdc’ 


organizat ion_name=’ cdc-gw’ 

internet_domain_name=’ cdc-gw.arhops.cdc.com’ 
bitnet_mailer_name=mailer .. 

bitnet_node_name=cdcarh .. 

. domain_names_file=$system.mailve_v2.domain_names_file 


Figure 3-2. Sample INSTALL _MAIL_GATEWAY Command 
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SREKCEKKEKEKKEKREKRKRECEREKEKERES DOMAIN NAMES FILE REKKSEKEERKEREKKSEKEKKEEK 

x 

* Local X.400 Hosts 

5 

:nick .VESYS.ARHOPS.CDC.COM .. 
:route.du=local ,ou=’ vesys’ ,on=’ vearh’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ 
X.400 

:x400 .ou=’vesys’ ,on=’vearh’ ,pd=’cdc’ ,ad=’attmail’ ,c=’us’ 

:internet .VESYS.ARHOPS .CDC.COM 

:internet .VESYS.ARHOPS.CDC.COM .. 

:X400 .ou=’ vesys’ ,on=’vearh’ ,pd=’cdc’ ,ad=’attmail’ ,c=’us’ 

* 

:nick.NETW.ARHOPS.CDC.COM .. 
:route.du=local,on=’cdcnet’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ 

X.400 

:X400 .on=’cdcnet’ ,pd=’cdc’ ,ad=’attmail’,c=’us’ 
:internet .NETW.ARHOPS.CDC.COM 

:internet .NETW.ARHOPS.CDC.COM .. 
>x400.on=’cdcnet’ ,pd=’cdc’ ,ad=’attmail’ ,c=’us’ 

* 

:nick.INTG.ARHOPS.CDC.COM .. 
:route.du=1o0cal,ou=’ sysc’ ,on=’ vearh’ ,ad=’attmail’ ,pd=’cdc’c=’us’, 
X.400 ; 

:X400 .ou=’sysc’ ,on=’vearh’ ,pd=’cdc’ ,ad=’attmail’,c=’us’ 

: internet .INTG.ARHOPS .CDC.COM 

: internet .INTG.ARHOPS.CDC.COM .. 

:X400.ou=’sysc’ ,on=’ vearh’ ,pd=’cdc’ ,ad=’attmail’,c=’us’ 


*The following set of entries are for BITNet usage. 
x 
:nick.CDCARH .. 
:route.du=local ,ou=’bitnet’ ,on=’vearh’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ 
X.400 
:X400 .ou=’bitnet’ ,on=’vearh’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ 
:internet .CDCARH 
:internet .CDCARH .. 
:X.400.ou="’bitnet’ ,on=’vearh’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ 
x 
*The following entry is for the gateway itself. 
*Note this :nick. entry supplies no X.400 address information. 
x 
:nick .CDC-GW.ARHOPS.CDC.COM .. 
:route.du=10cal 
X.400 


= 

:X400 .on=’cdc-gw’ ,pd=’cdc’ ,ad=’attmail’ ,c=‘us’ 
: internet .CDC-GW.ARHOPS.CDC.COM 

: internet .CDC-GW.ARHOPS.CDC.COM .. 
:>X400.on=’cdc-gw’ ,pd=’cdc’ ,ad=’attmail’ ,c=’us’ 


Figure 3-3. DOMAIN _NAMES _FILE Fragment 
(Continued) 
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(Continued) 


BSMTP BITNet Sites 


:mailer .CALMAIL@CALGARY 


Non-BSMTP BITNet Sites 
:route.du=ntf BITNET 
Define Default Route and Default Address 


*By default, the Mail/VE gateway hands messages to SMTP. 


:nick. *DEFAULT* :route.du=smtp 

x 

:nick. *<>* 
:route.du=local ,pn=’postmaster’ ,ou=’sysc’ ,on=’vearh’,.. 
c=’us’ ,ad=’attmail’ ,pd=’cdc’ 
X.400 


Figure 3-3. DOMAIN _NAMES_FILE Fragment 
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Define Organizations and Routes for Mail/VE Gateway 


create_organization .. 
title=mgcdc .. 
organizat ion_name=’ cdc-gw’ 
create_route .. 
title=mgcdc .. 
country=’us’ 
administrat ive_domain=’attmail’ 
private_domain=’cdc’ 
transfer_service=local 
dest inat ion_type=mg 


create_organization .. 
title=mtacdc .. 
organizat ion_name=’ vearh’ 
organization_unit=’ vesys’ 

8 

create_organization .. 
title=mtacdc 
organizat ion_name=’ vearh’ 
organizat ion_unit=’ sysc’ 

0 

create_organization .. 
title=mtacdc .. 
organizat ion_name=’ vearh’ 
organizat ion_unit=’bitnet ’ 

" 

create_organization .. 
title=mtacdc .. 
organi zat ion_name=’cdcnet’ 

" 

create_route . 
title=mtacdc .. 
country=’us’ 
administrat ive_domain=’attmail’ 
pr ivate_domain=’cdc’ 
transfer_service=local 
dest inat ion_t ype=mve 


Figure 3-4. Sample Organizations and Routes 


60464515 C Mail/VE Gateway 3-29 


Routing Examples 


From Internet to X.400 


In this example, the Mail/VE gateway receives mail with the following Internet. 
addresses. 


From: bob@ahse.cdc.com 
To: jane.a.smith@netw.arhops.cdc.com 


The recipient address matches a :nick. entry that directs the mail to the local X.400 
network, Mail/VE. The routing field of the matching :nick. entry directs the message to 
on=‘cdcnet’ ,pd=’cdc’ ,ad=’attmail’,c=’us’, and the :x400. field of the matching 
internet. entry causes the recipient's RFC822-style address to be translated into the 
appropriate X.400 address before delivery to the mailbox. 


From X.400 to Internet 
In this example, the Mail/VE gateway receives mail with the following X.400 addresses. 


From: pn=’jane a smith’ ,pd=’cdc’ ,ou=’cdcnet’ ,ad=’attmail’ ,c=’us’ 
To: pn=’ bobews1.acme.com’ 


The address of the Mail/VE user sending the mail is translated to RFC822 format via 
the matching :x400. entry to: . 


jane.a.smith@netw.arhops.cdc.com 
Since there is no :nick. entry which explicitly matches the destination domain name, 


ws1.acme.com, the :nick.*DEFAULT* entry is used. This causes the message to be 
queued for delivery by SMTP. 
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From BSMTP BITNet to X.400 


In this example, the Mail/VE gateway receives mail with the following BSMTP BITNet 
addresses. 


From: bob@calgary 
To: john.q.adams@CDCARH 


The recipient address matches a :nick. entry that directs the mail to the local X.400 
network, Mail/VE. The routing field of the matching :nick. entry directs the message to 
ou=’bitnet’ ,on=’vearh’ ,c=’us’ ,ad=’attmail’,pd=’cdc’, and the :x400. field of the 
matching :internet. entry causes the recipient's RFC822-style address to be translated 
into the appropriate X.400 address before delivery to the mailbox. 


From X.400 to BSMTP BITNet 
In this example, the Mail/VE gateway receives mail with the following X.400 addresses. 


From: pn=’john.q.adams’ ,pd=’cdc’ ,on=’vearh’ ,ou=’bitnet ‘ad=’attmail’ ,c=’us’ 
To: pn=’bob@vesta.calgary.edu’ 


The address of the Mail/VE user sending the mail is translated to RFC822 format via 
the matching :x400. entry to: 


John .Q.Adams@CDCARH 
The destination domain name, vesta.calgary.edu matches a :nick. entry which causes 


the message to be sent in a BSMTP envelope via NTF to a mail system with the 
BITNet address, CALMAIL@CALGARY. 
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From Non-BSMTP BITNet to X.400 


In this example, the Mail/VE gateway receives a non-BSMTP message from NTF, and 
the USER_INFORMATION output attribute of the message has the following value: 


user_informat ion=’onn=hqtrs,orn=frank, . 
dnn=cdcarh,drn=tom’ 


The Mail/VE gateway uses this information to generate the following sender and 
recipient addresses: 


From: frank@hgqtrs 
To: tomecdcarh 


The recipient address matches a :nick. entry which maps it to the local X.400 
destination: 


ou="bitnet’ ,on=’vearh’ ,pd=’cdc’ ,ad=’attmail’,c=’us’ 


The recipient address also matches an :internet. entry. The :x400. field of the matching 
Internet. entry allows the address to be translated to X.400 format before being 
delivered to the recipient's mailbox. 


From X.400 to Non-BSMTP BITNet 


In this example, the Mail/VE gateway receives mail with the following addresses. The 
first line is the sender's address (in X.400 format) and the second line is the recipient's 
address (in RFC822 format). 


From: pn=‘’tom’ ,c=’us’ ,ad=’attmail’ ,pd=’cdc’ ,on=’ vearh’ ,ou=’bitnet’ 

To: frank@hgtrs 
The Mail/VE gateway finds an :x400. entry which matches the sender's address. This 
causes the sender's address to be translated to RFC822 format: 


tomecdcarh 


: The Mail/VE gateway finds a :nick. entry which matches the recipient's address, hatrs. 
This causes the message to be queued without a BSMTP envelope for delivery by NTF. 
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This chapter provides reference information for the analyst who maintains Mail/VE 
Version 2. This chapter discusses: 


@ Mail/VE files 

@ Backing up and restoring Mail/VE directory files 

@ Editing a file of update subcommands 

@ Converting Mail/VE Version 1 directory files 

@ Maintaining a domain-wide directory 

The chapter also documents the following maintenance commands and subcommands: 
@ Mail/VE maintenance commands 

@ MANAGE_MAIL_DIRECTORY subcommands 


@ Mailbox and distribution list update subcommands 
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Mail/VE Files 


The Mail/VE files include configuration. files, a central directory, and a distributed 
database for messages. 


Configuration Files 


The following files are used in configuring a Mail/VE network. 


DOMAIN _NAMES _ FILE 


Contains commands that describe the translation of addresses between X.400 format 
and the RFC822 format used in BITNet and Internet networks. These commands 
also describe the destination networks for the recipients addressed by mail. In this 
manual, the default name, DOMAIN _NAMES_FILE, is used for the file. 
MAIL_INSTALLATION _ TABLE 


Contains Mail/VE Version 2 configuration parameters. 


MAILVE __CONFIGURATION 


Contains Mail/VE gateway configuration parameters. 


Central Directory Files 


The following files reside in the catalog named during the Mail/VE installation: 


ADDRESS _DIRECTORY 


Contains up to three entries for each entity defined on the database. An entity is a 
mailbox or a distribution list. The record definition includes a personal name, 
organization name, and organization units (1 to 4). 


DISTRIBUTION _LIST_CONTENTS 


Contains the address list for each distribution list defined on a database. There is 
at least one entry in the directory for each distribution list. 


ENTITY_DIRECTORY 


Contains an entry for each entity defined on this database. An entity is a mailbox 
or a distribution list. The record definition contains all names associated with the 
entity: organization name and units, description, and telephone number. For group 
entities, the record also contains the number of permission entries. For information 
on group mailboxes and distribution lists, refer to the Mail/VE Version 2 Usage 
manual. 
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@ PERMISSION _DIRECTORY 


Contains the list of permissions for each group entity on the database. A group 
entity is either a group mailbox or group distribution list. There is at least one 
entry for each group entity. For information on permissions, refer to the Mail/VE 
Version 2 Usage manual. 


@ ROUTE_DIRECTORY 


Contains an entry for each path in the mail network. The Mail/VE administrator is 
responsible for adding routes to this directory. 


e USER_DIRECTORY 


Contains an entry for each user who owns a mailbox or distribution list on the 
host. Each entry contains the user's NOS/VE user name, family name, default 
mailbox, and number of owned entities (that is, number of owned mailboxes and 
distribution lists). 


Distributed Database Files 


The MVF$ELECTRONIC_MAIL_DATABASE file resides in the master catalog of each 
Mail/VE Version 2 user. This file contains the user's messages, message headers, and 
various user options. 
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Directory Backup and Restore 


_ The MANAGE_MAIL_DIRECTORY (MANMD) utility provides subcommands for 

| backing up and restoring Mail/VE directory files that the users access. It does not 

| process the DOMAIN_NAMES_FILE nor the MVF$ELECTRONIC _MAIL_DATABASE 
. file. Only users whose MAILVE_ADMINISTRATION validation is set to ANALYST can 
. access this utility. 


| Normally, you use the NOS/VE BACKUP_PERMANENT_FILES and RESTORE _ 

. PERMANENT _FILES utilities to back up and restore the files you modify as Mail/VE 

: administrator before restoring the Mail/VE directory files. These files include the 
DOMAIN _NAMES_FILE, MAIL_INSTALLATION _TABLE, and MAILVE _ 
CONFIGURATION file in the $$SYSTEM.MAILVE_V2.MAIL catalog as well as the XTF 
configuration file in the $SYSTEM.XTF catalog. 


To back up a directory, execute the GENERATE_DIRECTORY_UPDATE subcommand 
during a MANAGE_MAIL_DIRECTORY utility session. The subcommand reads the 
current directory entries and creates a file of update subcommands. There are four 
update subcommands: 


~UPDATE_ORGANIZATION 
UPDATE _ROUTE 
UPDATE _DISTRIBUTION _LIST 
UPDATE __MAILBOX 


If necessary, you can edit the file of update subcommands to change the value of 
parameters on the subcommands. For additional information, see Editing a File of 
Update Subcommands later in this chapter. 


To restore a directory, execute the file of update subcommands during a MANAGE_ 
MAIL_DIRECTORY utility session. The following subsections describe how to back up 
and restore a directory file. 


WARNING 


. Using the MANAGE_MAIL_DIRECTORY utility ensures that Mail/VE directory files 
: are properly backed up and restored. Using the NOS/VE permanent file backup and 

: restore utilities may result in incorrect directory files. During a NOS/VE permanent 

= file backup, one or more of the Mail/VE directory files may be busy and therefore not 
: dumped. During a NOS/VE permanent file restore operation, any files that are not 

_ backed up are not restored. If Mail/VE directory files are not backed up and restored 
= as a group, the files may be incompatible. 
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Backing Up Directory Files 


To back up the Mail/VE directory files, you do not need exclusive access to the 
directory files. To back up a directory file, follow these steps: - 


1. Log in to the host using a Mail/VE analyst user name. Then, ade the Mail/VE 
maintenance commands to the command list: 


/create_command_list_entry .. 
.-/entry=$system.mailve_v2.maintenance.command_!ibrary 


2. Start the MANAGE_MAIL_DIRECTORY utility by entering the following 
command: — 


/manage_mail_directory 
Manmd/ 


3. Execute the GENERATE _DIRECTORY_UPDATE subcommand to translate the 
current directory entries into MANAGE_MAIL_DIRECTORY update subcommands. 
For example: 


Manmd/generate_directory_update .. 
Manmd. ./output=$system.mailve_ v2.mail. directory_backup 


4. Stop the MANAGE_MAIL_DIRECTORY utility session: 


Manmd/end_manage_mai1_directory 
/ 
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Restoring the Mail/VE Directory Files 


To restore the directory files, perform the following steps at the system console. You 
should attempt to restore the directory files only when you believe users will not be 
accessing Mail/VE. 


1. Obtain exclusive access to the directory files. The following procedure is an attempt 
to obtain exclusive access to these files during the restoration. 


a. Attempt to attach the Mail/VE user directory with exclusive access:’ — 


/task ring=4 

/attach_file .. 
../file=$system.mailve_v2.mail.user_directory . 
. ./share_mode=none 

/taskend 


If the attach is not successful because the directory file is busy, you must wait 
until existing users have finished using Mail/VE before re-entering the above 
commands. 


b.. Remove permits to the Mail/VE installation table file: 


/delete_file_permit .. 
../file=$system.mailve_v2.mail_installation_table . 
../group=public 


c. Ensure that all permits to the installation table file have been removed. The 
response to the following command should be NO PERMITS. If other permits 
are displayed, delete them. 


/display_catalog_entry .. 
../file=$system.mailve_v2.mail_installation_table . 
../display_opt ions=permits 


d. Deactivate the Mail/VE server: 
/deact ivate_mailve 


For a description of the DEACTIVATE_MAILVE command, see Mail/VE 
Maintenance Commands later in this chapter. 


e. Release the user directory file by entering the DETACH _FILE command: 


/detach_file .. 
../file=$system.mailve_v2.mail.user_directory 


2. Add the Mail/VE maintenance commands to the command list: 


/create_command_list_entry .. 
../entry=$system.mailve_v2.maintenance.command_library 


3. Start the MANAGE _MAIL_DIRECTORY utility by entering the following 
command: 


/manage_mail_directory . 


../errors=$system.mailve_v2.mail.restore_errors 
Manmd/ 
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4, Execute the update subcommands stored in the latest backup file. For example, to 
execute the subcommands in file $SYSTEM. MAILVE _V2.MAIL.DIRECTORY_. 
BACKUP, enter: 


Manmd/inciude_file .. 
Manmd. ./file=$system.mailve_v2.mail.directory_backup 


For information on using the INCLUDE_FILE command, see the NOS/VE System 
Usage manual. 


5. When the -file of update subcommands has finished executing, exit the MANAGE _ 
MAIL RECTORY utility session. 


Manmd/end_manage_mai1i_directory 
/ 


4. Examine the error file. If there are no errors or the-errors are tolerable, go to the 
next step. If the Mail/VE database files are not usable (that is, are missing valid 
mailboxes and distribution lists, routes to other mail systems, and so on), correct 
the problems and repeat the necessary steps. . 


The utility creates new high cycles for every Mail/VE Version 2 directory file. 
These files contain only the information provided by the file of update 
subcommands. 


7. Allow Mail/VE users to again access Mail/VE: 


/create_file_permit .. 
../file=$system.mailve_v2.mail_installation_table . 
. ./group=public 


8. Activate the Mail/VE server: 


/activate_mailve job_class=siteclass1 


On the JOB_CLASS parameter, specify a value appropriate for your site. For a 
description of the ACTIVATE_MAILVE command, see Mail/VE Maintenance 
Commands later in this chapter. 
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Editing a File of Update Subcommands 


You may need to edit the file of update subcommands if you are restoring the Mail/VE 
directory files or converting Mail/VE Version 1 directory entries. If so, you can use a 
text editor such as the EDIT —FILE utility to change parameter values on these 
subcommands. 


While editing a file of update subcommands, follow ‘thesé guidelines: 


Do not change any GLOBAL KEY values. You can change any other parameter 
values in the file. ; | 


UPDATE _ORGANIZATION subcommands must aoa all UPDATE _ 
DISTRIBUTION _LIST and UPDATE_MAILBOX subconimands. * 


When you modify any local address attributes (organization names, organization 
units, and personal names), make sure that the address is still unique within the 
private domain. For additional information on Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 


Proofread your editing carefully. 
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Converting Mail/VE Version 1 Directory Files 


If your site had been using Mail/VE Version 1, you can convert its directory of 
mailboxes and distribution lists for use with Mail/VE Version 2. (In this subsection, 
Mail/VE is referred to as Mail/VE Version 2 to ‘distinguish it from Mail/VE Version 1.) 
Before you can perform the conversion: 


@ Mail/VE Version 2 must be installed. 
® Your MAILVE_ADMINISTRATION level must be set to ANALYST. 


To convert the Mail/VE Version 1 directory of mailboxes and distribution lists, perform 
the following steps from the system console: 


1. Add the Mail/VE Version 2 maintenance commands to your command library by 
entering the following command: : 


/create_command_list_entry .. 
../entry=$system.mailve_v2.maintenance.command_library 


2. Inform all Mail/VE Version 1 users that you intend to convert the directory files 
for use with Mail/VE Version 2. Any changes they make after the conversion will 
not be included in the Mail/VE Version 2 files. 


3. Obtain exclusive access to the Mail/VE Version 1 directory files. The following 
procedure is an attempt to obtain exclusive access to these files during the 
conversion. You should take these steps only when you believe users will not be 
accessing Mail/VE Version 1. 


a. Attempt to attach the Mail/VE Version 1 family directory file with exclusive 
access: 


/task ring=4 

/attach_file .. 
../file=$system.mailve.mail.family_directory .. 
. ./share_mode=none 

/taskend 


If the attach is not successful because the directory file is busy, you must wait 
until existing users have finished using Mail/VE Version 1 before re-entering 
the above commands. 


b. Remove permits to the Mail/VE Version 1 directory catalog: 


/delete_catalog_permit .. 
../catalog=$system.mailve.mail .. 
../group=pubi ic 
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c. Ensure that all permits to the directory catalog have been removed. The 
response to the following command should be NO PERMITS. If other permits 
are displayed, delete them. 


/display_catalog .. 
../catalog=$system.mailve.mail 
../display_opt ions=permits 


d. Release the family directory file by entering the DETACH _FILE command: 


/detach_file .. 
.-/Fi le=$system.mailve.mail.family_directory 


4. Execute the CONVERT_MAILVE_DATABASE command and specify the catalog 
that contains the Mail/VE Version 1 directory files, an output file, and an error file 
as shown in the following example: 


/convert_mailve_database . 
../database_catalog=$system.mailve.mail .. 
../output=$system.mailve_v2.mail.vi_update . 
../errors=$system.mailve_v2.mail.error_file 


The CONVERT_MAILVE _DATABASE command reads the Mail/VE Version 1 
directory entries, translates the entries into MANAGE_MAIL_DIRECTORY 
subcommands, and stores the subcommands in the output file. 


5. Allow users to again access Mail/VE Version 1. 


/create_catalog_permit . 
../catalog=$system.mailve.mail .. 
../group=public . 
../access_mode=all 


6. If you have created organizations, you need to edit the file of update subcommands 
to include the organization names and/or units in the user mailbox and distribution 
list definitions. For information on editing the file of subcommands, refer to Editing 
a File of Update Subcommands earlier in this chapter. 


7. Obtain exclusive access to the Mail/VE Version 2 directory files. The following 
procedure is an attempt to obtain exclusive access to these files during the 
conversion. You should take these steps only when you believe users will not be 
accessing Mail/VE Version 2. 


a. Attempt to attach the Mail/VE Version 2 user directory with exclusive access: 


/task ring=4 

/attach_file .. 
../file=$system.mailve_v2.mail.user_directory .. 
. ./share_mode=none 

/taskend 


If the attach is not successful because the directory file is busy, you must wait 


until existing users have finished using Mail/VE Version 2 before reentering the 
above commands. 
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b. Remeve permits to. the Mail/VE Version 2 installation table file: 


/delete_file_permit . 
../file=$system.mailve_v2.mail_installation_table .. 
../group=public 


c. Ensure that all permits to the installation file have been removed. The response 
to the following command should be NO PERMITS. If other permits are 
displayed, delete them. 


/display_catalog_entry .. 
../file=$system.mailve_v2.mail_installation_table .. 
../display_opt ions=permits 


d. Deactivate the Mail/VE Version 2 server: 
/deact ivate_mai ive 


For a description of the DEACTIVATE_MAILVE command, see Mail/VE 
Maintenance Commands later in this chapter. 


e. Release the user directory file by entering the DETACH _FILE command: 


/detach_file .. 
../file=$system.mailve_v2.mail.user_directory 


8. Start a MANAGE_MAIL_DIRECTORY utility session and execute the 
GENERATE _DIRECTORY_UPDATE subcommand. For example: 


/manage_mail_directory 
Manmd/generate_directory_update .. 

Manmd. ./output=$system.mailve_v2.mail.v2_update 
Manmd/end_manage_mai1_directory 

/ 


9. Combine the two files of update subcommands produced by the CONVERT _. 
MAILVE _DATABASE and the GENERATE _DIRECTORY_UPDATE calls. For 
example: 


/copy_file .. 
../input=$system.mailve_v2.mail.vi_update .. 
../output=$system.mailve_v2.mail.v2_update.$eoi 


NOTE 


The Mail/VE Version 2 update subcommands must precede the Mail/VE Version 1 
update subcommands in the resulting file. 
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10. Execute the subeommands in the output file during a MANAGE_MAIL _ 
DIRECTORY utility session. For example to execute $SYSTEM.MAILVE _ 
V2.MAIL.V2_UPDATE, enter: 


/manage_mail_directory 

Manmd/include_file . 

Manmd. ./file=$system.mailve_v2.mail.v2_update 
Manmd/end_manage_mai1l_directory 

/ 


For information on using the INCLUDE_FILE command, see the NOS/VE System 
Usage manual. : 


When the MANAGE_MAIL_DIRECTORY utility session is ended, a new high cycle 
of each Mail/VE Version 2 directory file is created..-The new cycles reflect both the 
information from the converted Mail/VE Version 1 directory and the current 
Mail/VE Version 2 directory. 


11. Allow users to again access Mail/VE Version 2: 


/create_file_permit .. 
../file=$system.mailve_v2.mail_installation_table .. 
../group=public 


12. Activate the Mail/VE Version 2 server: 


/activate_mailve job_class=siteclass1 


On the JOB_CLASS parameter, specify a value appropriate for your site. For a 
description of the ACTIVATE _MAILVE command, see Mail/VE Maintenance 
Commands later in this chapter. 
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Maintaining a Domain-Wide Directory 


The MANAGE_MAIL_DIRECTORY utility contains commands and subcommands for 
maintaining a domain-wide directory. To execute these, you must have the MAILVE 
ADMINISTRATION validation set to ANALYST. 


A domain-wide directory provides the addresses of all mailboxes and distribution lists 
in a private domain. Within the central directory files on each host, the remote 
addresses are intermixed with local addresses so that users can look up addresses, 
display information about them, and address letters to them. 


There are two ways to create remote addresses on each host within a private domain: 
@ Manually with the ADMINISTER_MAIL subcommands 
@ Semi-automatically with domain-wide maintenance commands 


You create remote addresses manually with the CREATE_MAILBOX and CREATE_ 
DISTRIBUTION _LIST subcommands. To identify an address as remote, set the TITLE 
parameter on the SET_ATTRIBUTES subcommand to the name of the message transfer 
agent that serves a mailbox or distribution list. Mail/VE recognizes an address as 
remote when the title does not match the name of the local message transfer agent. 


Manually creating remote addresses is time-consuming and error-prone, particularly 
when a number of hosts share addresses. Using the domain-wide maintenance 
commands essentially automates the process to periodically exchange new or changed 
addresses between hosts. This process can be run off-line from Mail/VE execution so 
that the installation of remote address updates has little or no impact on Mail/VE 
users. 


Commands for Exchanging Remote Addresses 


Each of the following MANAGE_MAIL_DIRECTORY commands performs a step in the 
exchange of remote addresses. You may choose to use some or all of the commands 
depending upon the requirements of your Mail/VE configuration and your site. 
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Table 4-1. Commands for Exchanging Remote Addresses 


Commands 


GENERATE _ADDRESS_UPDATES 


SEND _ADDRESS __UPDATES 


COMBINE _UPDATE _LETTERS 


UPDATE __REMOTE _ADDRESSES 


GENERATE _REMOTE _UPDATES 


4-14 Mail/VE Version 2 Administration * 


Description 


Compares the old and new update files and 
creates a file of ADMINISTER_MAIL 
subcommands that define the new or 
changed addresses. 


Sends the file of ADMINISTER _MAIL 
subcommands (produced by GENERATE _ 
ADDRESS_UPDATES) to a mailbox on 
another host. The file is sent as the 
contents of a letter. 


Combines the letters received from other 
hosts into a file of ADMINISTER _ MAIL 
subcommands and deletes the letters from 
the mailbox (produced by GENERATE _ 
ADDRESS _UPDATES). 


Executes the GENERATE _REMOTE _ 
UPDATES subcommand on the file of 
ADMINISTER_MAIL subcommands and 
then executes the ADMINISTER_MAIL ~ 
command to install the remote mailbox and 
distribution list addresses in ADDRESS _ 
DIRECTORY and ENTITY_DIRECTORY. 


Removes any local address definitions from 
the file of ADMINISTER _MAIL 
subcommands. This command ensures that a 
host does not receive its own addresses from 
another host. 
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Creating a File for Address Exchange 


To create a file of ADMINISTER _MAIL subcommands for address exchange, follow 
these steps. 


1. Add the Mail/VE Version 2 maintenance commands to the command list by entering 
the following command: 


/create_command_list_entry .. 
../e=$system.mailve_v2.maintenance.command_1ibrary 


2. Start a MANAGE_MAIL_DIRECTORY utility session and execute the 
GENERATE _DIRECTORY_UPDATE subcommand. For example: 


/manage_mail_directory 
Manmd/generate_directory_update .. 
Manmd. ./output=$system.mailve_v2.mail.directory_backup.$next 


3. Stop the MANAGE_MAIL_DIRECTORY Bed session by entering the following 
command: 


MANMD/end_manage_mail_directory 


4, Execute the GENERATE _ADDRESS_UPDATES command to create a file of 
ADMINISTER MAIL subcommands for address exchange: 


/generate_address_updates . 
../new_directory_update_file=$system.mailve_v2.mail. aircetonys backup.$high .. 

ccfoldcdinectery updatect ies ¢system.mailve_v2.mail.directory_backup.$low . 

../output=$system.mailve_v2.mail.address_updates 

/ 


If the DIRECTORY_BACKUP file does not already exist, then omit the OLD_ 
DIRECTORY_UPDATE _FILE parameter on the GENERATE _ADDRESS __UPDATES 
command and the following step. In this case, the file of ADMINISTER_MAIL 
subcommands contains all of the mailboxes and distribution lists in the 
DIRECTORY_BACKUFP file. 


5. Delete the old cycle of the DIRECTORY_BACKUP file: 


/delete_file $system.mailve_v2.mail.directory_backup.$low 
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Sending the File to Another Host 


| To distribute a file of ADMINISTER_MAIL subcommands created by the GENERATE _ 
ADDRESS _UPDATES command, follow these steps: 


1. Determine the organization name and organization units for the host to receive the 
ADMINISTER _MAIL subcommands file for address exchange. 


2. Add the Mail/VE Version 2 maintenance commands to the command list by entering 
the following command: 


/create_command_list_entry .. 
../e=$system.mailve_v2.maintenance.command_library 


3. Execute the SEND_ADDRESS_UPDATES command to send the file to the remote 
host. In this example, the organization name is orgname and the organization units 
are orgunit. 


/send_address_updates . 
../updates_file=$system.mailve_v2.mail.address_updates .. 
../organizat ion_name=’orgname’ 

../organizat ion_units=’orgunit ’ 


/ 


By default, the remote host receives the file in a letter at the POSTMASTER 
mailbox. The subject of the letter is MVF$MAIL_ADDRESS_UPDATES. 


Installing Remote Addresses 


| To install the remote addresses received from other hosts, follow these steps: 


1. Add the Mail/VE Version 2 maintenance commands to the command library by 
entering the following command: 


/create_command_list_entry .. 
../e=$system.mai lve_v2.maintenance.command_library 


2. Enter the COMBINE _UPDATE _LETTERS command to combine the address 
exchange letters in the POSTMASTER mailbox into a file of ADMINISTER_MAIL 
subcommands for address exchange. The subject of each of these getters is 
MVF$MAIL_ADDRESS_UPDATES. 


/combine_update_letters .. 
.-/output=$system.mailve_v2.mail.remote_updates 


| 3 Enter the UPDATE_REMOTE_ADDRESSES command to install the file of 
ADMINISTER_MAIL subcommands produced by COMBINE __UPDATE _LETTERS. 


/update_remote_addresses .. 
../remote=$system.mailve_v2.mail.remote_updates 
/ 


This step updates the local central directory files by adding the remote mailboxes 
and distribution lists that are new or changed. 
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Administering Remote Addresses 


Some of the ADMINISTER_MAIL subcommands that apply to local mailboxes and 
distribution lists also apply to remote mailboxes and distribution lists. These 
subcommands enable you to perform the following activities: 


® Delete remote mailboxes and distribution lists through the DELETE_MAILBOX and 
DELETE _DISTRIBUTION _LIST subcommands. 


@ . Display a remote mailbox or distribution list (by specifying its address) using the 
DISPLAY_MAILBOX and DISPLAY_DISTRIBUTION _LIST subcommands. 


However, you cannot use the CHANGE_MAILBOX and CHANGE _DISTRIBUTION _ 
LIST subcommands to change address attributes of remote mailboxes or distribution 
lists. 


Displaying Address Attributes 


Not all of the address attributes recorded for local mailboxes and distribution lists are 
recorded for their remote counterparts. The following list details the differences: 


Available Address Attributes Unrecorded Information 


@ Personal name and aliases @ Permitted addresses for group mailboxes 


and distribution lists 
e Organization name and organization 


units @e Address list for distribution lists 


@ Telephone number @ User and family owning a mailbox or 
distribution list 


@ Description 


e Autoforward address for mailboxes 
@ Retention period for mailboxes 


@ Permit type 


@ Expand option for distribution lists 
of FALSE 


Enforcing Permissions 


Mail/VE does not enforce permissions for remote mailboxes and distribution lists. 
Instead, the receiving Mail/VE system enforces them. For example, a user who is not 
permitted access to a remote group mailbox may try sending mail to the mailbox. The 
Mail/VE system receiving this mail does not deliver it, but returns a nondelivery 
notice. 
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Mail/VE Maintenance Commands | 


: This section provides reference information for 13 Mail/VE maintenance commands. 
= ‘These commands reside on the following two libraries: | 


e $SYSTEM.MAILVE _V2.MAINTENANCE.COMMAND _LIBRARY 
- COMBINE_UPDATE_LETTERS command 
- CONVERT_MAILVE_DATABASE command 
- GENERATE_ADDRESS_UPDATES command 
~- GENERATE _REMOTE_UPDATES command 
- INSTALL_MAIL command 
- INSTALL_MAIL_GATEWAY command 
-~ MANAGE_MAIL_DIRECTORY command 
- SEND_ADDRESS_UPDATES command 
- UPDATE _REMOTE_ADDRESSES command : 
° $SYSTEM.OSF$BUILTIN _LIBRARY 
- ACTIVATE MAIL _GATEWAY command 
~- ACTIVATE _MAILVE command 


- DEACTIVATE _MAIL_GATEWAY command 
—- DEACTIVATE _MAILVE command 


To access the commands, your MAILVE_ADMINISTRATION validation level must be 
set to ANALYST. 
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ACTIVATE _MAIL _GATEWAY 


Purpose Defines and activates a job for the Mail/VE gateway, which is responsible 
for exchanging mail with Internet or BITNet networks. 


Format ACTIVATE _MAIL_GATEWAY 
JOB _CLASS =name 
LOAD _MAP=file 
STATUS =status variable 
Parameters JOB CLASS or JC 
Specifies the job class under which the Mail/VE ee runs. 
The default is your system's default batch class. 


LOAD _MAP or LM 
Specifies the file to which the load map is written. 
The default is file $NULL. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this Soman 
Remarks e This command is entered from the system console. 


@ This command should normally be entered only once per deadstart. If 
you need to enter a DEACTIVATE_MAIL_GATEWAY command, then 
you must enter the ACTIVATE _MAIL_GATEWAY command again to 
reactivate the Mail/VE gateway. 
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ACTIVATE _MAILVE 


Purpose Defines and activates.a system job for the Mail/VE server, which is 
responsible for delivering mail. 


| Format ACTIVATE _MAILVE 
JOB _CLASS =name 
‘LOAD _MAP=file 
STATUS =status variable 
= Parameters JOB_CLASS or JC 
Specifies the job class under which Mail/VE runs. 
The default is your system's default batch class. 


LOAD _MAP or LM 
Specifies the file to which the load map is written. 
The default is file $NULL. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this command. 


: Remarks e@ This command is entered from the system console. 


@ This command should normally be entered only once per deadstart. If 
you need to enter a DEACTIVATE_MAILVE command, then you must 
enter the ACTIVATE _MAILVE command again to reactivate the 
Mail/VE server. 
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- COMBINE _UPDATE _LETTERS 


Purpose Reads the letters distributed by SEND_ADDRESS_UPDATES commands to 
a mailbox, combines the files in them into a single file of ADMINISTER _ 
MAIL subcommands, and deletes those letters from the mailbox. 


Format COMBINE _UPDATE _LETTERS or 
COMUL . i 

PERSONAL _NAME =record or string 
ORGANIZATION _UNITS =string 
ORGANIZATION _NAME =string 
REMOTE _UPDATES =file 
DELETE _UPDATE _LETTERS = boolean 
STATUS =status variable 


Parameters PERSONAL NAME or PN 
Specifies the name of the mailbox receiving the letter. Enter the name as 


a l- through 256-character string or a record of the following format: 


record 
surname: string i. .40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 


record elements are optional. 
The default is POSTMASTER. 


ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 

REMOTE _UPDATES or RU 

Specifies the output file for the combined letters. 

The default is a new cycle of the file MAIL_ADDRESS_UPDATES in the 
current working catalog. 

DELETE _UPDATE _LETTERS or DUL 


Specifies the letters should be deleted from the mailbox after they have 
been copied to the file specified on the REMOTE_UPDATES parameter. 


FALSE 
The letters are not deleted from the mailbox. 
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The letters are deleted from the mailbox. 
The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME. 
Specifies the completion status for this command. | 
Remarks The subject assigned to all letters sent to a POSTMASTER mailbox by 


SEND_ADDRESS_UPDATES commands is MVF$MAILBOX _ADDRESS _ 
UPDATES. . 
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CONVERT_MAILVE _DATABASE 


Purpose 


Format 


Parameters 


Remarks 
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Translates Mail/VE Version 1 directory entries into UPDATE_MAILBOX 
and UPDATE _DISTRIBUTION _LIST subcommands and stores the 
subcommands in the output file. The file of subcommands can be executed 
during a MANAGE_MAIL_DIRECTORY utility session to create entries in 
the Mail/VE Version 2 directory files. 


CONVERT_MAILVE _DATABASE or 
CONMD 
DATABASE _CATALOG = file 
OUTPUT =file 
ERRORS =file 
STATUS =status variable 
DATABASE _CATALOG or DC 
Specifies the catalog that contains the Mail/VE Version 1 directory files. 


The default is $$5YSTEM.MAILVE.MAIL. 


OUTPUT or O 
Specifies the file to which output is written. 
The default is file $OUTPUT. 


ERRORS or E 
Specifies the file to which errors are written. 
The default is file $ERRORS. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this command. 


® Mail/VE Version 2 must be installed before vou can execute this 
command. 


© To execute this command, the user must have a permit to catalog 
$SYSTEM.MAILVE with an ACCESS_MODE of 
(ALL,CYCLE,CONTROL) and a SHARE_MODE of (NONE). 


© Letters from Mail/VE Version 1 are not converted to Mail/VE 


Version 2. To avoid losing these letters, users can copy them into 
permanent files before Mail/VE Version 1 is removed from the system. 
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DEACTIVATE _MAIL_GATEWAY 
7 Purpose Deactivates and removes the job for the Mail/VE gateway. 


Format DEACTIVATE _MAIL _GATEWAY 
STATUS =status variable 
Parameters STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 
Remarks e@ This command is entered from the system console. 


© After the Mail/VE gateway is deactivated by this command, you must 
use the ACTIVATE _MAIL_GATEWAY command to reactivate the 
gateway. 


© The job log is written to the file $SYSTEM.MAILVE_V2.MAILVE _ 
MG_JOB _LOG. 
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DEACTIVATE _MAILVE 
Purpose Deactivates and removes the job for the Mail/VE server. 


Format DEACTIVATE _MAILVE 
STATUS =status variable 


Parameters STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 


Remarks @ This command is entered from the system console. 


e After the Mail/VE server is deactivated by this command, you must use 
the ACTIVATE_MAILVE command to reactivate the Mail/VE server. 


© The job log is written to the file $;5YSTEM.MAILVE_V2.MAILVE _ 
JOB _LOG. 
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GENERATE _ADDRESS _UPDATES 


Purpose 


Parameters 


Remarks 


Creates a file of ADMINISTER_MAIL subcommands that define the 
changes to the local mailboxes and distribution lists on the host. 


GENERATE _ADDRESS _UPDATES or 
GENAU 
NEW_DIRECTORY_UPDATE _FILE= file 
OLD _DIRECTORY _UPDATE _FILE=file 
OUTPUT =file 
STATUS =status variable 


NEW_DIRECTORY_UPDATE _FILE or NDUF 


Specifies the most recent file of ADMINISTER_MAIL subcommands by 
executing the GENERATE_DIRECTORY_UPDATES command. 


OLD __DIRECTORY_UPDATE _FILE or ODUF 


Specifies the previous file of ADMINISTER_MAIL subcommands created by 
executing the GENERATE __DIRECTORY_UPDATES command. 


OUTPUT or O 
Specifies the file to which output is written. 
The default is file $OUTPUT. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 


© This command compares two MANAGE_MAIL_DIRECTORY files and 
generates commands that define the mailbox and distribution list 
changes between the files. This comparison excludes remote mailboxes 
or distribution lists; that is, any mailbox or distribution list with a title 
that is different from its message transfer agent (MTA). It also excludes 
subcommands that define mail routes and organizations. 


6 If you do not specify the OLD_DIRECTORY_UPDATE _FILE parameter 
or if the file is empty, GENERATE_ADDRESS_UPDATES creates an 
output file containing the ADMINISTER_MAIL subcommands to create 
the mailboxes and distribution lists in the NEW_DIRECTORY_ 
UPDATE _FILE file. 


© The OUTPUT file includes all group, private, and public mailboxes and 
distribution lists. 
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GENERATE _REMOTE _UPDATES 


Purpose 


Format 


Parameters 
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Creates a file of ADMINISTER_MAIL subcommands that define changes to 
remote mailboxes and distribution lists. Any subcommands defining local 
mailboxes or distribution lists are removed from the file. 


GENERATE _REMOTE _UPDATES or 
GENRU 
REMOTE _UPDATES = file 
OUTPUT =file 
STATUS =status variable 
REMOTE _UPDATES or RU 


Specifies a file of ADMINISTER_MAIL subcommands produced by the 
GENERATE _REMOTE_UPDATES command on a remote host or by the 
COMBINE _UPDATE_LETTERS command on the local host. 

OUTPUT or O 

Specifies the file to which output is written. 

The default is file $OUTPUT. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. | 


Mail/VE Maintenance 4-27 


Mail/VE Maintenance Commands 


INSTALL _MAIL 


Purpose 


Format 


Parameters 


Installs Mail/VE Version 2 and initializes the Mail/VE Version 2 
installation table and database. 


INSTALL_MAIL or 
INSM 
MESSAGE _TRANSFER _AGENT =string or name 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN = string 
COUNTRY =string 
DATABASE _CATALOG =file 
MTA _CLASS = integer 
STATUS =status variable 


MESSAGE _TRANSFER _AGENT or MTA 


Specifies the message transfer agent (MTA) name to assign to this Mail/VE 
installation. Enter as a name or as a 1- through 12-character string 
composed of alphabetic and numeric characters. Control Data recommends 
using MTA as the first three characters of this name. 


PRIVATE _DOMAIN or PD 

Specifies the private domain name with which this Mail/VE installation is 
associated. Enter the domain as a 1- through 16-character string. 
ADMINISTRATIVE _DOMAIN or AD 


Specifies the administrative domain name with which this Mail/VE 
installation is associated. Enter the domain as a 1- through 16-character 
string. If the installation is not associated with an administrative domain, 
specify the domain as a single blank. 


COUNTRY or C 


Specifies the country code with which this Mail/VE installation is 
associated. Enter the code as a 1- through 3-character string. See 
appendix C for the list of countries and their associated codes. 


DATABASE _CATALOG or DC 


Specifies the catalog for the Mail/VE database files. 


The default is MAILVE_V2.MAIL. You should use the default value for 
the DATABASE_CATALOG parameter. This causes the directory files to be 
placed in catalog $5YSTEM.MAILVE_V2.MAIL. 


4-28 Mail/VE Version 2 Administration 60464515 C 


Mail/VE Maintenance Commands 


MTA _CLASS or MC 
Specifies the routing class used by the local MTA. 


1 


Organization name determines routing. 


2 


Organization name and organization units determine routing. 


3 


Organization name, organization units, and personal name determine 
routing. 


The default is 2. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 
Remarks @® INSTALL_MAIL must be executed from the system console. 


© The Mail/VE installation table entries define this Mail/VE installation 
and are used as default values by the mail system. 
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INSTALL _MAIL GATEWAY 


Purpose Defines the installation and configuration for the Mail/VE gateway. 
Format INSTALL _MAIL _GATEWAY or | 
INSMG | 


MAIL _GATEWAY_NAME=string or name 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 

ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
INTERNET _DOMAIN _NAME =string 
DOMAIN _NAMES _FILE=file 

BITNET _MAILER _NAME=name 
BITNET __NODE _NAME=name 
STATION =key or name 

STATUS =status variable 


Parameters MAIL GATEWAY_NAME or MGN 


Specifies the name of the Mail/VE gateway. For multihost message transfer 
directly to the gateway, the name must be registered as a network title. 
Enter as a name or as a 1- through 12-character string composed of 
alphabetic and numeric characters. Control Data recommends using MG as 
the first two characters of this name. 


PRIVATE _DOMAIN or PD 

Specifies the private domain name with which this Mail/VE gateway is 
associated. Enter the domain as a 1- through 16-character string. 
ADMINISTRATIVE _DOMAIN or AD 


Specifies the administrative domain name with which this Mail/VE gateway 
is associated. Enter the domain as a 1- through 16-character string. If the 
gateway is not associated with an administrative domain, specify the 
domain as a single blank. 


COUNTRY or C 


Specifies the country code with which this Mail/VE gateway is associated. 
Enter the code as a 1- through 3-character string. See appendix C for the 
list of countries and their associated codes. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
Mail/VE gateway. Enter each unit as a 1- through 32-character string. The 
order in which you specify the unit names is significant; address lookup 
procedures determine a match based on the order. 


ORGANIZATION _NAME or ON 


Specifies the name of the organization associated with the gateway. Enter 
the name as a 1- through 64-character string. 
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INTERNET_DOMAIN _NAME or IDN 


Specifies the Internet domain name for the Mail/VE gateway. This name is 
the hierarchical series of Internet domains that address the Mail/VE 
gateway. Enter the name as a 1- through 255-character string. Control 
Data recommends using the host name with a suffix of -GW. 


DOMAIN _NAMES _FILE or DNF 


Specifies the file path to the file containing the domain names and routing 
and translation definitions. . 


The default is $5YSTEM.MAILVE _V2.DOMAIN __NAMES_FILE. 


BITNET _MAILER _NAME or BMN 


Specifies the name of the Mail/VE gateway registered with the BITNet 
Network Information Center. Enter the name as a 1- through 8-character 
name. Control Data recommends that you use the name MAILER. 


BITNET _NODE _NAME or BNN 


Specifies the node name of the host on which the Mail/VE gateway is 
installed. The name is registered with the BITNet Network Information 
Center. Enter the name as a 1- through 8-character name. 


STATION or S 


Specifies the station name used by the Mail/VE gateway when routing files 
through the Network Transfer Facility (NTF). 


The default value is AUTOMATIC, which directs NTF to use the 
AUTOMATIC _STATION _NAME specified at NTF activation via the 
ACTIVATE _NTF command. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 
e INSTALL_MAIL_GATEWAY is entered from the system console. 


@ The COUNTRY and ORGANIZATION _UNIT parameters define the 
X.400 address attributes that identify the Mail/VE gateway. The 
gateway may be located in the same private domain as other Mail/VE 
message transfer agents, or it may be in a different private domain. 


The following parameters provide routing information to the Mail/VE 
gateway from within a BITNet or Internet network. 


Network Parameter 

BITNet BITNET_MAILER __NAME 
BITNet BITNET_NODE_NAME 
Internet INTERNET_DOMAIN _NAME 


o MAIL_INSTALLATION _TABLE entries define the Mail/VE installation 
and are default values for the Mail/VE gateway. 


© Mail/VE must be installed before you can install the Mail/VE gateway. 
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MANAGE _MAIL _DIRECTORY 


Purpose 


Format 


Parameters 


Starts the MANAGE_MAIL_DIRECTORY utility. 
MANAGE _MAIL_DIRECTORY or 


MANMD 
OUTPUT =file 
ERRORS = file 
STATUS =status variable 
OUTPUT or O 
Specifies the file to which output is written. 
The default is file $OUTPUT. 


ERRORS or E 
Specifies the file to which errors are written. 
The default is file ${RRORS. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 
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SEND __ADDRESS _UPDATES 


Purpose Creates a letter which contains the GENERATE _ADDRESS_UPDATES 
output and sends it to the specified mailbox. 


Format SEND __ADDRESS __UPDATES or 
SENAU 
UPDATES _FILE=file 
RECIPIENT __PERSONAL _NAME= record or string 
RECIPIENT ORGANIZATION _NAME =string . 
RECIPIENT ORGANIZATION _UNITS =string 
ORIGINATOR _PERSONAL _NAME=record or string 
ORIGINATOR _ORGANIZATION _NAME =string 
ORIGINATOR _ORGANIZATION _UNITS =string 
STATUS =status variable _ 


Parameters UPDATES _FILE or UF 
Specifies the file containing the GENERATE _ADDRESS_UPDATES output. 


RECIPIENT __PERSONAL _NAME or RPN 


Specifies the name of the mailbox receiving the letter. Enter the name as 
a 1- through 256-character string or a record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 


The default is POSTMASTER. 
RECIPIENT _ORGANIZATION _NAME or RON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


RECIPIENT ORGANIZATION _UNITS or RECIPIENT _ 
ORGANIZATION _UNIT or ROU 


Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 


ORIGINATOR _PERSONAL __NAME or OPN 


Specifies the name of the mailbox from which the letter is sent. Enter the 
name as a 1- through 256-character string or a record of the following 
format: 
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record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 


ORIGINATOR _ORGANIZATION __NAME or OON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


ORIGINATOR _ORGANIZATION _UNITS or ORIGINATOR _ 
ORGANIZATION _UNIT or OOU 


Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this command. 


Remarks © The subject assigned to all letters created by SEND_ADDRESS_ 
UPDATES commands is MVF$MAILBOX _ADDRESS __UPDATES. 


© If you do not enter the PERSONAL_NAME parameter, the SEND_ 
ADDRESS_UPDATES command sends the letter to the POSTMASTER 
mailbox with the specified organization name and organization units. 
The COMBINE _UPDATE _LETTERS command, which processes 
SEND _ADDRESS_UPDATES letters, expects the POSTMASTER 
mailbox to contain letters from one or more hosts. 


You can use the PERSONAL_NAME parameter to send the letter to a 
distribution list whose address list consists of the POSTMASTER 
mailboxes at the hosts receiving the MVF$MAIL_ADDRESS_UPDATES 
letter. 
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UPDATE __REMOTE _ADDRESSES 


Purpose Adds the new and changed remote mailboxes and distribution lists to the 
local central directory files. This command executes the GENERATE _ 
REMOTE _UPDATES subcommand to exclude local mailbox and 
distribution lists from the update and then executes the ADMINISTER _ 
MAIL command to update the central directory files. 


Format © UPDATE_REMOTE _ADDRESSES or 
UPDRA 
REMOTE _UPDATES = file 
STATUS =status variable 
Parameters REMOTE_UPDATES or RU 


Specifies a file of ADMINISTER_MAIL subcommands produced by the 
GENERATE __REMOTE _UPDATES command on a remote host or by the 
COMBINE _UPDATE _LETTERS command on the local host. 

STATUS 

Special attributes: VAR, BY_NAME 


Specifies the completion status for this command. 
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MANAGE _MAIL_DIRECTORY Subcommands 


This section provides reference information for the MANAGE_MAIL_DIRECTORY 
utility subcommands. A MANAGE_MAIL_DIRECTORY session is normally a backup 
or restore session. If it is a backup session, only two MANMD subcommands are used: 


END _MANAGE_MAIL_DIRECTORY 
GENERATE _DIRECTORY_UPDATE 


A restore session typically consists of a number of the following update subcommands 
followed by an END_MANAGE_MAIL_DIRECTORY subcommand. 


UPDATE _DISTRIBUTION _LIST 

‘“UPDATE_MAILBOX 
UPDATE _ORGANIZATION 
UPDATE _ROUTE 


The UPDATE subcommands are usually those created during an earlier backup session 
or a CONVERT_MAILVE __DATABASE session. 
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END _MANAGE _MAIL_DIRECTORY 
MANMD Subcommand 


Purpose 


Format 


Parameters 
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Stops a MANAGE_MAIL_DIRECTORY utility session. 


END _MANAGE _MAIL_DIRECTORY or 
ENDMMD or 
END or 
QUIT or 
QUI 
SAVE = boolean. 
STATUS =status variable 


SAVE or S 
Specifies whether the updates made during this utility session are saved or 
discarded. Enter one of the following keywords: 


FALSE 
Updates made during this utility session are discarded. 


TRUE 


Updates made during this utility session are saved. New high cycles for 
every Mail/VE directory file are created. The content of these new files 
is generated only from the update subcommands. Therefore, you must 
input a complete set of update subcommands or the new files will 
contain incomplete information. 


The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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GENERATE _DIRECTORY_UPDATE 
MANMD Subcommand 


-~ 


Purpose Generates a file of update subcommands to back up the current directory 
database files. This file can be used during a subsequent MANAGE _ 
MAIL _DIRECTORY session to restore a Mail/VE directory. 


Format GENERATE _DIRECTORY_UPDATE or 
GENDU 
OUTPUT =file 
ERRORS = file 
STATUS =status variable 
Parameters OUTPUT or O 
Specifies the file to which output is written. 
The default is the output file specified on the MANAGE_MAIL_ 
DIRECTORY command. 
ERRORS or E — 
Specifies the file to which errors are written. 
The default is the error file specified on the MANAGE_MAIL_ 
DIRECTORY command. 
STATUS . 
Special attributes: VAR, BY_NAME Ps 
Specifies the completion status for this subcommand. 
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UPDATE _DISTRIBUTION _LIST 
MANMD Subcommand 


Purpose 


Format 


Parameters 


Remarks 
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~ 


Starts a subutility to add a distribution list entry to the mail database. 


UPDATE _DISTRIBUTION _LIST or 
UPDDL 

GLOBAL _KEY=name 

TITLE = string 

USER =name 

FAMILY =name. 

STATUS =status variable 
GLOBAL _KEY or GK 
Specifies an identifier for the distribution list that is unique within the 
private domain. 
TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the Mail/VE 
installation where this distribution list is defined. Enter the name as a 
1- through 32-character string. 


USER or USER __NAME or UN or U 
Specifies the NOS/VE user name of the distribution list owner. 


FAMILY or F 
Specifies the NOS/VE family name of the distribution list owner. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


For information on the four subcommands of the UPDATE _ 
DISTRIBUTION _LIST subutility, refer to the Mailbox and Distribution 
List Update Subcommands later in this chapter. 
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UPDATE _MAILBOX 
MANMD Subcommand 


Purpose 


Format 


Parameters 


Remarks 


~ 


Starts a subutility to add a mailbox entry to the mail database. 


UPDATE _MAILBOX or 
UPDM 

GLOBAL _KEY=name 

TITLE = string 

USER =name 

FAMILY =name 

DEFAULT _MAILBOX = boolean 

STATUS =status variable 
GLOBAL _KEY or GK 
Specifies.an identifier for the mailbox that is unique within the private 
domain. 
TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the Mail/VE 
installation where this mailbox is defined. Enter the name as a 1- through 
32-character string. 


USER or USER __NAME or UN or U 
Specifies the NOS/VE user name of the mailbox owner. 


FAMILY or F 
Specifies the NOS/VE family name of the mailbox owner. 


DEFAULT MAILBOX or DM 


Specifies whether the mailbox is the owner's default mailbox. Enter one of 
the following keywords: 


FALSE 


Mailbox is not the owner's default mailbox. 


TRUE 
Mailbox is the owner's default mailbox. 
The default is the keyword FALSE. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


For information on the four subcommands of the UPDATE_MAILBOX 


subutility, refer to the Mailbox and Distribution List Update Subcommands 


later in this chapter. 
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UPDATE _ORGANIZATION 
MANMD Subcommand 


Purpose 


Format 


Parameters 


Remarks 
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~ 


Defines an organization entry in the Mail/VE address directory. 


UPDATE _ORGANIZATION or 

UPDO 
TITLE = string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
STATUS =sitatus variable 


TITLE or T 

Specifies the message transfer agent (MTA) name assigned to the 
destination mail system. Enter the name as a 1- through 32-character 
string. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units. Enter each unit as a 
1- through 32-character string. The order in which you specify the unit 
names is significant; address lookup procedures determine a match based 
on the order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization. Enter the name as a 1- through 
64-character string. 

STATUS . 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 

@® You must specify a value for the ORGANIZATION _UNIT or 


ORGANIZATION __NAME parameter or you will receive an error 
message. 


@ UPDATE_ORGANIZATION subcommands must precede any UPDATE _ 
DISTRIBUTION _LIST or UPDATE _MAILBOX subcommands during a 
restore procedure. 
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UPDATE _ROUTE 
MANMD Subcommand 


~ 


Purpose Defines a route entry in the Mail/VE directory. 
Format UPDATE _ROUTE or 
UPDR 


TITLE = string 

COUNTRY =string 

ADMINISTRATIVE _DOMAIN =string 
PRIVATE _DOMAIN =string 

TRANSFER _SERVICE=keyword or string 
DESTINATION _TYPE=keyword or string 
TRANSFER _TITLE =string 

STATUS =status variable 


Parameters TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the 
destination mail system. Enter the name as a 1- through 32-character 
string. 

COUNTRY or C 

Specifies the country code of the destination mail system. Enter the code 
as a 1- through 3-character string. See appendix C for the list of countries 
and their associated codes. 

ADMINISTRATIVE _DOMAIN or AD 

Specifies the administrative domain of the destination mail system. Enter 
the domain as a 1- through 16-character string. 

PRIVATE _DOMAIN or PD a 


Specifies the private domain of the destination mail system. Enter the 
domain as a 1- through 16-character string. 


TRANSFER _SERVICE or TS 
Specifies the transfer service used to route mail to the destination mail 
system. Enter one of the following keywords or a 1- through 31-character 
string. 
LOCAL 
The service defined by DESTINATION _TYPE is directly routed to the 
service, which is resident on this NOS/VE host. 
QTF 
The transfer service is the Queue File Transfer Facility (QTF), which 
transfers mail from one Mail/VE system to another Mail/VE system. 
XTF 


The transfer service is the X.400 Transfer Facility (XTF), which 
transfers mail from one Mail/VE system to another Mail/VE system or 
to another X.400 mail system. 


The default is the keyword QTF. 
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DESTINATION _TYPE or DT 


Specifies the type of destination mail system. Enter one of the following 
keywords or a 1- through 31-character string. 


MG 
The destination mail system is the Mail/VE directory. 


MVE 
The destination mail system is a Mail/VE system. 
The default is the keyword MVE. 


TRANSFER _TITLE or TT 


Specifies the QTF title of the host through which the message transfer 
agent (MTA) defined by the TITLE parameter can be reached. Enter the 
title as a 1- through 32-character string. 


The default is the value specified for the TITLE parameter. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


Remarks When entering an UPDATE_ROUTE command, specify values for the 
COUNTRY, ADMINISTRATIVE _DOMAIN, and PRIVATE _DOMAIN 
parameters. If the MTA name is not associated with an administrative 
domain, specify the administrative domain by entering a single space. 
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Mailbox and Distribution List Update Subcommands 


This section provides reference information for the following subcommands of the 
UPDATE _DISTRIBUTION _LIST (UPDDL) and UPDATE _MAILBOX (UPDM) 


subutilities: 

UPDATE _DISTRIBUTION _LIST UPDATE _MAILBOX 
ADD_ADDRESS ACTIVATE __AUTO_FORWARDING 
ADD_PERMISSION ADD _PERMISSION 


-END_UPDATE_DISTRIBUTION _LIST END __UPDATE _MAILBOX 
SET_ATTRIBUTES SET_ATTRIBUTES 
To stop an UPDATE_MAILBOX subutility session, use the END_UPDATE_MAILBOX 


subcommand; to stop an UPDATE _DISTRIBUTION _LIST subutility session, use the 
END _UPDATE _DISTRIBUTION _LIST subcommand. 
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ACTIVATE _AUTO _FORWARDING 
UPDM Subcommand 


Purpose 


Format 


Parameters 
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Specifies a mailbox to which mail is automatically forwarded. 


ACTIVATE __AUTO _FORWARDING or 
ACTAF 
PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
UA _IDENTIFIER =string 
TERMINAL _IDENTIFIER =string 
X121 ADDRESS =string . 
DOMAIN _DEFINED _ATTRIBUTES =list of record 
POSTAL _ADDRESS =list of string 
POSTAL _ADDRESS _COUNTRY_NAME =string 
POSTAL _ADDRESS _CODE =string 
STATUS =siatus variable 


PERSONAL __NAME or PN 


Specifies the name of the mailbox to which mail is automatically 
forwarded. Enter the name as a 1- through 256-character string or as a 
record of the following format: 


record 
surname: string 1. .40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 
ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units. associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 


ORGANIZATION _NAME or ON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


PRIVATE _DOMAIN or PD 


‘Special attributes: BY_NAME, ADVANCED 


Specifies the private domain of the mailbox. Enter the domain as a 
1- through 16-character string. 
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ADMINISTRATIVE _DOMAIN or AD 

Special attributes: BY_NAME, ADVANCED 

Specifies the administrative domain of the mailbox. Enter the domain as a 
1- through 16-character string. 

COUNTRY or C 

Special attributes: BY_NAME, ADVANCED 

Specifies the country code of the mailbox. Enter the code as a 

1- through 3-character string. See appendix C for the list of countries and 
their associated codes. 

UA __IDENTIFIER or UI 

Special attributes: BY_NAME, ADVANCED 

Specifies the user agent (UA) identifier of the mailbox. The UA identifier 
must be unique within the specified domain. Enter a string of 1 through 
32 characters. 

TERMINAL _IDENTIFIER or TI 

Special attributes: BY_NAME, ADVANCED 

Specifies the terminal identifier of a telematic terminal on which the mail 
is read. Enter a string of 1 through 24 characters. 

X121_ADDRESS or XA 

Special attributes: BY_.NAME, ADVANCED 


Specifies the address of the mailbox as specified in accordance with 
recommendation X.121. Enter a string of 1 through 15 characters composed 
of the digits 0 through 9. 


DOMAIN _DEFINED _ATTRIBUTES or DDA 

Special attributes: BY_NAME, ADVANCED 

Specifies a list of 1 through 4 non-X.400 attributes of the mailbox. Enter 
each attribute as a record of the following format: 


record ; 
name: string 1..8 
value: string 1..128 
recend 
POSTAL _ADDRESS or PA 
Special attributes: BY NAME, ADVANCED 


Specifies information that describes the physical postal delivery system of 
the mailbox. Enter the information with a list of 2 through 6 strings of 
1 through 30 characters each. 

POSTAL __ADDRESS _COUNTRY_NAME or PACN 

Special attributes: BY_ NAME, ADVANCED 


Specifies the postal address country name of the mailbox. Enter a string of 
1 through 30 characters. 
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POSTAL _ADDRESS _CODE or PAC 

Special attributes: BY_NAME, ADVANCED 

Specifies the postal address code of the mailbox. Enter a string of 
1 through 128 characters. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


Remarks For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 
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ADD _ADDRESS 
UPDDL Subcommand 


~ 


Purpose Specifies an address to add to a distribution list. 


Format ADD _ADDRESS or 
ADDA 
PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
UA _IDENTIFIER =string 
TERMINAL _IDENTIFIER =string 
4121 _ADDRESS =string 
DOMAIN _DEFINED _ATTRIBUTES =list of record 
POSTAL _ADDRESS =list of string 
POSTAL _ADDRESS _COUNTRY _NAME =string 
POSTAL _ADDRESS _CODE =string 
STATUS =status variable 


Parameters PERSONAL _NAME or DISTRIBUTION _LIST or PN or DLN 


Specifies the name of the mailbox or distribution list to add to the 
distribution list. Enter the name as a 1- through 256-character string or a 
record of the following format: 


record 
surname: string 1. .40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox or distribution list. Enter each unit as a 1- through 32-character 
string. The order in which you specify the unit names is significant; 
address lookup procedures determine a match based on the order. 
ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox or 
distribution list. Enter the name as a 1- through 64-character string. 
PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 


Specifies the private domain of the mailbox or distribution list. Enter the 
domain as a 1- through 16-character string. 
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ADMINISTRATIVE _DOMAIN or AD 

Special attributes: BY_NAME, ADVANCED 

Specifies the administrative domain of the mailbox or distribution list. 
Enter the domain as a 1- through 16-character string. 

COUNTRY or C 

Special attributes: BY_NAME, ADVANCED 

Specifies the country code of the mailbox or distribution list. Enter the 
code as a 1- through 3-character string. See appendix C for the list of 
countries and their associated codes. 

UA __IDENTIFIER or UI 

Special attributes: BY_NAME, ADVANCED 

Specifies the user agent (UA) identifier of the mailbox or distribution list. 
The UA identifier must be unique within the specified domain. Enter a 
string of 1 through 32 characters. 

TERMINAL _IDENTIFIER or TI 

Special attributes: BY_NAME, ADVANCED 

Specifies the terminal identifier of a telematic terminal on which the mail 
is read. Enter a string of 1 through 24 characters. 

X121__ADDRESS or XA 

Special attributes: BY_NAME, ADVANCED 


Specifies the address specified in accordance with recommendation X.121. 
Enter a string of 1 through 15 characters composed of the digits 0 through 
9. 


DOMAIN _DEFINED _ATTRIBUTES or DDA 
Special attributes: BY_NAME, ADVANCED 
Specifies a list of one through four non-X.400 attributes of the address. 


Enter each attribute as a record of the following format: 


record 
name: string 1..8 
value: string 1..128 
recend 


POSTAL _ADDRESS or PA 


Special attributes: BY_NAME, ADVANCED 


Specifies information that describes the physical postal delivery system of 
the address. Enter the information with a list of 2 through 6 strings of 
1 through 30 characters each. 


POSTAL _ADDRESS _COUNTRY_NAME or PACN 
Special attributes: BY_NAME, ADVANCED 


Specifies the postal address country name of the address. Enter a string of 
1 through 30 characters. 
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POSTAL _ADDRESS _CODE or PAC 

Special attributes: BY_NAME, ADVANCED 

Specifies the postal address code of the address. Enter a string of 
1 through 128 characters. 

STATUS 

Special attributes: VAR, BY NAME 

Specifies the completion status for this subcommand. 


Remarks For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 
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ADD _PERMISSION 
UPDDL and UPDM Subcommands 


Purpose 


Format 


Parameters 
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Adds a mailbox to the group permitted to use the mailbox or distribution 
list. 


ADD _PERMISSION or 

ADDP 
PERSONAL _NAME =record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
PERMISSIONS =keyword or list of payor 
STATUS =status variable 


PERSONAL __NAME or PN 


Specifies the name of the mailbox permitted to use this group mailbox or 
group distribution list. Enter the name as a 1- through 256-character 
string or as a record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified ‘as a record, the surname is required and the other 
record elements are optional. . 
ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 

Specifies the private domain of the mailbox. Enter the domain as a 1- 
through 16-character string. 

ADMINISTRATIVE _DOMAIN or AD 

Special attributes: BY_NAME, ADVANCED 


Specifies the administrative domain of the mailbox. Enter the domain as a 
1- through 16-character string. 
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COUNTRY or C 
Special attributes: BY_NAME, ADVANCED 
Specifies the country code of the mailbox. Enter the code as a 
1- through 3-character string. See appendix C for the list of countries and 
their associated codes. 
PERMISSIONS or P 
Special attributes: BY _NAME 
Specifies the access permitted to the mailbox. Enter the keyword ALL or 
specify one or more of the following keywords. Specifying ALL establishes 
READ and WRITE permission for mailboxes and READ and USE 
permission for distribution lists. 
READ or R 
For mailboxes, letters can be read; for distribution lists, the list can be 
displayed. 
WRITE or W 


For mailboxes only. Letters can be sent to the mailbox. 


USE or U 


For distribution lists only. Distribution lists can be included in a 
recipient list. However, without READ access, users cannot expand the 
distribution list. 


The default is the keyword ALL. 


STATUS 
Special attributes: VAR, BY_ NAME 


Specifies the completion status for this subcommand. 


Remarks e@ The wildcard character (*) can indicate parts of the address not 
specified. 


© For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 
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END _UPDATE _DISTRIBUTION _LIST 
UPDDL Subcommand 


Purpose 


Format 


Parameters 
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. 


Stops an UPDATE_DISTRIBUTION _LIST subutility session. 


END _UPDATE _DISTRIBUTION _LIST or 
ENDUDL or 
END or 
QUIT or 
QUI 
SAVE = boolean. 
STATUS =status variable 
SAVE or S 
Specifies whether the changes made during this subutility session are 
saved or discarded. Enter one of the following keywords: 
FALSE 


Changes made during this subutility session are discarded. 


TRUE 
Changes made during this subutility session are saved. 
The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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END _UPDATE _MAILBOX 
UPDM Subcommand 


Purpose Stops an UPDATE_MAILBOX subutility session. 


. 


Format END _UPDATE _MAILBOX or 
ENDUM or 
END or 
QUIT or 
QUI 
SAVE = boolean 
STATUS =status variable 
Parameters SAVE or S 
Specifies whether the changes made during this subutility session are 
saved or discarded. Enter one of the following keywords: 
FALSE 


Changes made during this subutility session are discarded. 


TRUE 
Changes made during this subutility session are saved. 
The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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SET _ATTRIBUTES 
UPDDL Subcommand 


Purpose 


Format 


Parameters 
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Defines or changes distribution list attributes. 


SET_ATTRIBUTES or 

SET_ATTRIBUTE or 

SETA . 
DISTRIBUTION _LIST_NAME=list of keyword or record or string 
ORGANIZATION _UNITS =list of keyword or string 
ORGANIZATION _NAME Sstring 
DESCRIPTION =string 
TELEPHONE _NUMBER =string 
EXPAND = boolean 
PERMIT _TYPE =keyword 
TITLE =string 
STATUS =status variable 


DISTRIBUTION _LIST _NAME or DLN 


Specifies a list of one through three elements to describe the distribution 
list. The first element of the list is always used in displays. The second 
and third elements are aliases. Each element can be the keyword NO_ 
CHANGE or a 1- through 64-character string or a record of the following 
format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as the keyword NO_CHANGE or a 1- 
through 32-character string. The order in which you specify the units is 
significant; address lookup procedures determine a match based on the 
order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the distribution list. 
Enter the name as a 1- through 64-character string. 

DESCRIPTION or D — . 

Special attributes: BY_NAME 

Specifies a 1- through 64-character string that describes the distribution 
list. 

TELEPHONE _NUMBER or TN 

Special attributes: BY_NAME 


Specifies the telephone number of the distribution list owner. Enter a 
string of 1 through 32 characters. 
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EXPAND or E 
Special attributes: BY_NAME 


Specifies whether or not the distribution list will be expanded when used. 
The EXPAND parameter applies only to distribution lists residing on the 
same host as the sender. Otherwise, no expansion can occur regardless of 
the value of the EXPAND attribute. 


FALSE 

Distribution list is not expanded. The distribution list name is used in 
the letter header. 

TRUE 


Distribution list is expanded. The distribution list name is replaced by 
the addresses contained in the distribution list. 


The default is that the parameter value remains set as last specified. 


PERMIT __TYPE or PT 
Special attributes: BY_NAME 
Specifies the type of distribution list permission. Enter one of the following 
keywords. 
GROUP or G 
A group of defined mailboxes can use the distribution list. To add 
mailboxes to the group, use the ADD_PERMISSION subcommand. 
PRIVATE or PR 
Only the owner of the distribution list can use the list. 


PUBLIC or PU 
Any user can use the distribution list. 


The default when creating a distribution list is PRIVATE; the default for 
existing distribution lists is that the PERMIT_TYPE remains unchanged. 


TITLE or T 
Special attributes: BY NAME 


Specifies the message transfer agent (MTA) name assigned to the Mail/VE 
installation where this distribution list is defined. Enter the name as a 1- 
through 32-character string. 


The default is the local message transfer agent (MTA). 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 
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SET_ATTRIBUTES 
UPDM Subcommand 


Purpose 


Format 


Parameters 
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Defines or changes mailbox attributes. 


SET_ATTRIBUTES or 

SET_ATTRIBUTE or 

SETA 
PERSONAL _NAME=list of keyword or record or string 
ORGANIZATION _UNITS =list of keyword or neleee 
ORGANIZATION _NAME =string 
DESCRIPTION =string 
TELEPHONE _NUMBER =string 
RETENTION _PERIOD=keyword or integer 
PERMIT __TYPE=keyword 
TITLE =string 
STATUS =status variable 


PERSONAL _NAME or PN 


Specifies a list of one through three elements to describe the mailbox. The 
first element of the list is always used in displays. The second and third 
elements are aliases. Each element can be the keyword NO_CHANGE or a 
1- through 64-character string or a record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as the keyword NO_CHANGE or a 1- through 
32-character string. The order in which you specify the units is significant; 
address lookup procedures determine a match based on the order. 
ORGANIZATION __NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

DESCRIPTION or D 

Special attributes: BY_NAME 

Specifies a 1- through 64-character string that describes the mailbox. 


‘TELEPHONE _NUMBER or TN 


Special attributes: BY _NAME 


Specifies the telephone number of the mailbox owner. Enter a string of 1 
through 32 characters. 
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RETENTION _PERIOD or RP 
Special attributes: BY_NAME 


Specifies the number of days a letter is retained in the mailbox after it 
has been seen. Enter the keyword MAXIMUM or an integer value for the 
number of days to retain letters. 


The default is the value set by the MAILVE_RETENTION _LIMIT 
validation. 
PERMIT __TYPE or PT 
Special attributes: BY_NAME 
Specifies the type of mailbox permission. Enter one of the following 
keywords. 
GROUP or G 
A group of defined mailboxes can read mail from or send mail to the 
mailbox. To add mailboxes to the group, use the ADD_PERMISSION 
subcommand. 
PRIVATE or PR 
Only the owner of the mailbox can read mail from the mailbox. Anyone 
can send mail to the mailbox. 
PUBLIC or PU 
Any user can read mail from or send mail to the mailbox. 


The default when creating a mailbox is PRIVATE; the default for existing 
mailboxes is that the PERMIT_TYPE remains unchanged. 


TITLE or T 
Special attributes: BY_NAME 


Specifies the message transfer agent (MTA) name assigned to the Mail/VE 
installation where this mailbox is defined. Enter the name as a 1- through 
32-character string. 


The default is the local message transfer agent (MTA). 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 
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ADMINISTER_MAIL Utility = #48 


This chapter describes how to use the ADMINISTER_MAIL utility and provides 
reference information for the following; 


@e ADMINISTER _MAIL command and subecommands 
® Mailbox and distribution list subutility subcommands 


@ Functions 


Using the ADMINISTER _MAIL Utility 


The following sections describe how you access the ADMINISTER_MAIL utility, stop a 
session, and set utility defaults. 


Starting the Utility 


To access the ADMINISTER_MAIL utility, your MAILVE_ADMINISTRATION 
validation level must be set to ANALYST, SYSTEM, or FAMILY. 


To start the utility, enter: 
/administer_mail 

The system displays the following prompt: 
Admm/ 


When the Admm/ prompt is displayed, the ADMINISTER_MAIL subcommands and 
functions are available for use. 


Stopping the Utility 
To stop the utility, enter: 


Admm/end_administer_mai 1 
/ 


60464515 C a ADMINISTER_MAIL Utility 5-1 


ADMINISTER_MAIL Command and Subcommands 


Setting Utility Defaults 


The ADMINISTER_MAIL utility maintains default values for FAMILY and USER. 
* When. you start the utility, it sets the default value for FAMILY to the value you 
| specified during login and sets the default value for USER to the value you specified 
: during login. | 


When you execute a utility subcommand that provides optional FAMILY and USER 
parameters, the default for the FAMILY parameter is the current utility default for 
, FAMILY; the default for USER is the current utility default for USER. 


You implicitly change the default values for FAMILY and USER (that set 

$A DMINISTERED _FAMILY and $ADMINISTERED_USER) whenever you specify 
values for FAMILY and USER parameters on utility subcommands, but you also 
implicitly change these values by specifying the PERSONAL_NAME parameter on the 
following subcommands: 


CHANGE _DISTRIBUTION _LIST 
CHANGE _MAILBOX 

DELETE _DISTRIBUTION _LIST 
DELETE _MAILBOX 
DISPLAY_DISTRIBUTION _LIST 
DISPLAY_MAILBOX 


You can explicitly set the values of FAMILY and USER by using the SELECT_USER 
subcommand. 


You can determine the current default for FAMILY and USER by using two 
ADMINISTER _MAIL functions: 


S$ADMINISTERED _ FAMILY 
$ADMINISTERED _USER 


For example, to display the current default value for the family, enter: 


/administer_mail 
Admm/display_value $administered_family 


ADMINISTER _MAIL Command and Subcommands 
: The following section describes the ADMINISTER_MAIL command and subcommands. 
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ADMINISTER _MAIL 
Purpose Starts the ADMINISTER_MAIL utility. 


Format ADMINISTER _MAIL or 
ADMM 
OUTPUT = file 
ERRORS = file 
STATUS =status variable 


Parameters OUTPUT or O 


Specifies the file to which output is written. 
The default is file $OUTPUT. 


ERRORS or E 
Specifies the file to which error messages are written. 
The default is file $£RRORS. 


STATUS 
Special attributes: VAR, BY_NAME. 
Specifies the completion status for this command. 
Remarks © The ADMINISTER_MAIL utility can be used only by users whose 


MAILVE_ADMINISTRATION validation level is set to ANALYST, 
SYSTEM, or FAMILY. 


© At utility startup, the system sets the default value for FAMILY to the 
value you specified during login; the system sets the default for USER 
to the name you specified during login. 


@ The OUTPUT parameter value is the default for the OUTPUT 
parameters of many of the ADMINISTER_MAIL subcommands. 
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CHANGE _DISTRIBUTION _LIST 
ADMM Subcommand 


Purpose Initiates the CHANGE _DISTRIBUTION _LIST subutility, through which 
you can change the definition of any distribution list for which you have 
MAILVE ADMINISTRATION validation. After you have specified the 
parameters for the CHANGE _DISTRIBUTION _LIST subcommand, the 
system displays Chad1/, prompting you to enter subutility subcommands 
listed below under Remarks. 


Format CHANGE _DISTRIBUTION _LIST or 
CHADL 
DISTRIBUTION _LIST_NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
STATUS =status variable 


Parameters DISTRIBUTION _LIST_NAME or DLN 
Specifies the name of the distribution list to be changed. Enter the name 


as a 1- through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
‘initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as a 1- through 32-character string. The 
order in which you enter the unit names is significant; address lookup 
procedures determine a match based on the order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the distribution list. 
Enter the name as a 1- through 64-character string. 

STATUS 

Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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Remarks @ Use the following CHANGE _DISTRIBUTION _LIST subutility 
subcommands to specify new distribution list attributes, edit address: 
lists, and edit permission lists of group distribution lists. 


ADD_ADDRESS 

ADD _PERMISSION 

DELETE _ADDRESS 

DELETE _PERMISSION 
DISPLAY_ADDRESS _LIST 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 

END CHANGE _DISTRIBUTION _LIST 
SET_ATTRIBUTES . 


These subcommands are described later in this chapter under Mailbox 
and Distribution List Subutility Subcommands. 


@ Only the distribution list owner and the Mail/VE administrator can 
change a distribution list. 


@ If vou change a local distribution list, $ADMINISTERED_FAMILY and 
S$ADMINISTERED _USER are set to the identity of the NOS/VE user 
who owns the distribution list. There is no change to 
$ADMINISTERED _FAMILY and $ADMINISTERED _USER if the 
distribution list is a remote list. 


® If the address parameters do not uniquely identify a distribution list 
you can change, the CHANGE_DISTRIBUTION _LIST subutility 
terminates and displays an error message. 


® You cannot use the wildcard character (*) in address parameters. 


© Changing a group distribution list to private or public deletes the 
permission list that defines the group. 


Examples The following example adds an address to an existing distribution list. 


Admm/change_distribution_list . 

Admm. ./distribut ion_list_name=’project_members’ 
Chad!l/add_address .. 
Chad1../personal_name=’ Janet Strong’ 
Chad1/add_permission . 
Chad!../personal_name=’ Janet Strong’ 
Chad1/end_change_distribution_list 

Admm/ 
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This example changes a private distribution list to a group distribution 
list. 


Admm/change_distribution_list 

Admm ../distribut ion_]list_name=’t iger_team’ 
Chad!/set_attributes .. 

Chad! ../permit_type=group 
Chad!/add_permission .. 

Chad!../organizat ion_name=’qa department’ 
Chad]/add_permission .. 

Chad!, ./organizat ion_name= 
Chad!../’Continuous Improvement Task Force’ 
Chad!/end_change_distribution_list 

Admm/ 
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CHANGE _MAILBOX 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 
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Starts the CHANGE MAILBOX subutility to change the definition of a 
mailbox for which you have MAILVE __ADMINISTRATION validation. After 
you have specified the parameters for the CHANGE_MAILBOX 
subcommand, the system displays Cham/, prompting you to enter subutility 
subcommands listed below under Remarks. 


CHANGE _MAILBOX or 
CHAM . 
~PERSONAL_NAME=string or record 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
STATUS =status variable 


PERSONAL_NAME or PN 


Specifies the name of the mailbox to change. Enter the name as a 1- 
through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you enter the unit names is significant; address lookup procedures 
determine a match based on the order. 


ORGANIZATION __NAME or ON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


© Use the following CHANGE_MAILBOX subutility subcommands to 
change mailbox attributes and edit the access permission lists of group 
mailboxes. 


ADD_PERMISSION 
DELETE __PERMISSION 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 
END CHANGE _MAILBOX 
SET_ATTRIBUTES 


These subcommands are described later in this chapter under Mailbox 
and Distribution List Subutility Subcommands. 
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® If you change a local mailbox, $ADMINISTERED _FAMILY and 
$ADMINISTERED _USER are set to the identity of the NOS/VE user 
who owns the mailbox. There is no change to $ADMINISTERED _ 
FAMILY and $ADMINISTERED _USER if the mailbox is a remote 
mailbox. 


@ Only the mailbox owner and the Mail/VE administrator can change a 
mailbox. 


¢ For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 
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CREATE _DISTRIBUTION _LIST 
ADMM Subcommand 


Purpose Initiates the CREATE __DISTRIBUTION _LIST subutility through which you 
create a distribution list for the $ADMINISTERED_USER. After you have 
specified the parameters for the CREATE_DISTRIBUTION _LIST 
subcommand, the system displays Cred!/, prompting you to enter subutility 
subcommands listed below under Remarks. 


Format CREATE _DISTRIBUTION _LIST or 
CREDL ae 
STATUS =status variable 


Parameters STATUS 
Special attributes: VAR, BY_NAME 


‘Specifies the completion status for this subcommand. 


Remarks @ Use the following CREATE _DISTRIBUTION _LIST subutility 
subcommands to define distribution lists, create address lists, and create 
permission lists. 


ADD_ADDRESS 

ADD _PERMISSION 

DELETE _ADDRESS 

DELETE _PERMISSION 
DISPLAY_ADDRESS _LIST 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 

END _CREATE _DISTRIBUTION _LIST 
SET_ATTRIBUTES 


These subcommands are described later in this chapter under Mailbox 
and Distribution List Subutility Subcommands. 


@ The address attributes you specify for the distribution list through the 
SET_ATTRIBUTES subcommand must uniquely identify the list you are 
creating for $ADMINISTERED_USER. If the address is not unique 
when you enter the END_CREATE _DISTRIBUTION _LIST 
subcommand, the distribution list is not created and the subutility 
terminates with an error message. 


© Your distribution list can be made up of the addresses of mailboxes 
and/or other distribution lists. 


® The values of $ADMINISTERED_USER and $ADMINISTERED _ 
FAMILY at the time you enter the END_CREATE_DISTRIBUTION _ 
LIST subcommand determine the user for whom the distribution list is 
created. 
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Examples The following example creates a distribution list for $ADMINISTERED _. 
USER. . 


Admm/create_distribut ion_list 

Credl/set_attribute .. 

Cred]. ./distribut ion_1ist_name=( 
Cred1../:’Fellow_Trainees’ ‘dift’) 
Cred1../expand=true 

Cred!l/add_address personal_name=’Jim Rivers’ 
Cred!/add_address personal_name=’ Joan C Lohn-Cho’ 
Credl/end_create_distribution_list true 

Admm/ 
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CREATE _MAILBOX 
ADMM Subcommand 


Purpose Initiates the CREATE _MAILBOX subutility through which you can create 
a mailbox. After you have specified the parameters for the CREATE _ 
MAILBOX subcommand, the system displays Crem/, prompting you to enter 
subutility subcommands listed below under Remarks. 


Format CREATE _ MAILBOX or 
CREM 
STATUS = status variable 


Parameters STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


Remarks @ Use the following CREATE MAILBOX subutility subcommands to 
define mailbox attributes and create access permission lists that define 
group mailboxes. 


ADD __PERMISSION 
DELETE _PERMISSION 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 
END _CREATE _MAILBOX 
SET_ATTRIBUTES 


These subcommands are described later in this chapter under Mailbox 
and Distribution List Subutility Subcommands. 


@ The MAILVE_ADMINISTRATION validation determines who can create 
mailboxes: 


- A user whose MAILVE_ADMINISTRATION validation level is set to 
ANALYST or SYSTEM can create mailboxes for users of any family 
on the host. 


- A user whose MAILVE_ADMINISTRATION validation level is set to 
FAMILY can create mailboxes only for users of their family. 


@ The values of $ADMINISTERED_FAMILY and $ADMINISTERED _ 
USER at the time you enter the END_CREATE _MAILBOX 
subcommand determine the user for whom the mailbox is created. 
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CREATE _ORGANIZATION 
ADMM Subcommand 


Purpose Defines an organization entry in the Mail/VE address directory and 
associates a message transfer agent (MTA) name with the organization. 


Format CREATE _ORGANIZATION or 
CREO . 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
TITLE =string 
STATUS =status variable 


Parameters ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units. Enter each unit as a 
1- through 32-character string. The order in which you enter the unit 
names is significant; address lookup procedures determine a match based 
on the order. 


ORGANIZATION _NAME or ON 

Specifies the name of the organization. Enter the name as a 1- through 
64-character string. . 

TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the 
destination mail service. Enter the name as a 1- through 32-character 
string. 

The default is the local MTA name returned by the $MAILVE_ 
INSTALLATION function. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 
Remarks e Each organization definition is associated with only one MTA name. 
That is, only one MTA name is associated with a given organization 
name and its ordered set of organization units. As a minimum, you 


must specify either the organization name and/or the ordered set of 
organization units. 


© The TITLE parameter on the CREATE_ORGANIZATION subcommand 
must match a TITLE parameter on a CREATE_ROUTE subcommand. 


5-12 Mail/VE Version 2 Administration . 60464515 C 


ADMINISTER_MAIL Command and Subcommands 


CREATE _ROUTE 
ADMM Subcommand 


Purpose 


Format 


Parameters 
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Defines a route entry in the Mail/VE directory. 


CREATE _ROUTE or 

CRER 
TITLE = string 
COUNTRY =string 
ADMINISTRATIVE _DOMAIN =string 
PRIVATE _DOMAIN =string | 
TRANSFER _SERVICE =keyword or string 
DESTINATION _TYPE=keyword or string 
TRANSFER _TITLE =string 
PASSWORD =string 
STATUS =status variable 


TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the 
destination mail service. Enter the name as a 1- through 32-character 
string. 


COUNTRY or C 


Specifies the country code of the destination mail service. The code is 
entered as a 1- through 3-character string. Enter this code if it is different 
than the country code of the MTA. See appendix C for the list of countries 
and their associated codes. 


ADMINISTRATIVE _DOMAIN or AD 

Specifies the administrative domain of the destination mail service. The 
domain is entered as a 1- through 16-character string. Enter this domain if 
it is different than the administrative domain of the MTA. 

PRIVATE __DOMAIN or PD 


Specifies the private domain of the destination mail service The domain is 
entered as a 1- through 16-character string. Enter this domain if it is 
different than the private domain of the MTA. 


TRANSFER _SERVICE or TS 
Specifies the residency of the DESTINATION _TYPE service which routes 
the mail to the destination mail service. Enter one of the following 
keywords or a 1- through 31-character string. 
LOCAL 
The service defined by DESTINATION _TYPE. Mail is directly routed 
to the service, which is resident on this NOS/VE host. 
QTF 


A transfer service called the Queue File Transfer Facility (QTF), which 
transfers mail from one Mail/VE system to another Mail/VE system. It 
is not resident on this NOS/VE host. 
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Remarks 


XTF 


A transfer service called the X.400 Transfer Facility (XTF), which 
transfers mail from one Mail/VE system to another Mail/VE system or 
to another X.400 mail system. It is not resident on this NOS/VE host. 


The default is the keyword QTF. 


DESTINATION _TYPE or DT 


Specifies the type of destination mail service. Enter one of the following 
keywords or a 1- through 31-character string. 


MG 


The destination mail service is the Mail/VE gateway. 


MVE 
The destination mail service is a Mail/VE system. 
The default is the keyword MVE. 


TRANSFER _TITLE or TT 


Specifies the QTF title of the host through which the message transfer 
agent (MTA) defined by the TITLE parameter can be reached. Enter the 
title as a 1- through 32-character string. 


The default is the value specified for the TITLE parameter. 
PASSWORD or PW 


Specifies the password of the destination X.400 mail service transferring 
mail through XTF. Enter the 1- through 64-character string as specified in 
uppercase or lowercase. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. © 


e@ The CREATE_ROUTE subcommand can be used only by users whose 
MAILVE _ADMINISTRATION validation level is set to ANALYST. If 
you are specifying the XTF option on the TRANSFER_SERVICE 
parameter, you must have a permit to the XTF configuration file. For 
additional information, see General Configuration Procedure: Using 
NOS/VE and Other X.400 Hosts in chapter 2. 


e If the ENABLE_PASSWORD_CHECKING parameter is TRUE on the 
ACTIVATE _XTF command, MTA names and passwords are checked 
when mail systems establish associations. The MTA name and password 
specified on this CREATE_ROUTE command must match the MTA 
name and password that the destination mail system sends. The check 
for password is case-sensitive; the check for MTA name is not 
case-sensitive. 


® When entering a CREATE_ROUTE command, specify values for the 
COUNTRY, ADMINISTRATIVE _DOMAIN, and PRIVATE _DOMAIN 
parameters. If the MTA name is not associated with an administrative 
domain, specify the administrative domain by entering a single space. 
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DEFINE _DEFAULT _GATEWAY_ADDRESS 
ADMM Subcommand 


Purpose Defines the X.400 address of the default Mail/VE gateway. Mail/VE uses 
the address when a user enters an RFC822-formatted address as the 
recipient of a letter, but does not enter the X.400 address of the Mail/VE 
gateway to reach that recipient. 


Format DEFINE _DEFAULT_GATEWAY_ADDRESS or 
DEFDGA 

ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
STATUS =status variable 


Parameters ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 
Specifies the list of one to four organization units for the default Mail/VE 
gateway address. Enter each unit as a 1- through 32-character string. The 
order in which you enter the unit names must be the same order you 
specified when you created the organization. 
ORGANIZATION _NAME or ON . 
Specifies the name of the organization for the default Mail/VE gateway 
address. Enter the name as a 1- through 64-character string. 
PRIVATE _DOMAIN or PD 
Specifies the private domain name with which the default Mail/VE gateway 
address is associated. Enter the domain as a 1- through 16-character 
string. 
ADMINISTRATIVE _DOMAIN or AD 


Specifies the administrative domain name with which the default Mail/VE 
gateway address is associated. Enter the domain as a 1- through 
16-character string. If the Mail/VE gateway is not associated with an 
administrative domain, enter the domain as a single blank. 


COUNTRY or C 


Specifies the country code with which the default Mail/VE gateway address 
is associated. Enter the code as a 1- through 3-character string. See 
appendix C for the list of countries and their associated codes. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 
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DELETE _DISTRIBUTION _LIST 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Deletes a distribution list from the Mail/VE directory. 


DELETE _DISTRIBUTION _LIST or 

DELDL 
DISTRIBUTION _LIST_NAME= record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
STATUS =status variable 


DISTRIBUTION _LIST_NAME or DLN 


Specifies the name of the distribution list to be deleted. Enter the name as 
a 1- through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as a 1- through 32-character string. The 
order in which you enter the unit names is significant; address lookup 
procedures determine a match based on the order. 


ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the distribution list. 

Enter the name as a 1- through 64-character string. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 

@ The name of the distribution list is not deleted from other distribution 
lists that contain it. If you or another user attempts to send letters to 


nonexistent addresses on remote hosts, nondelivery notices are returned. 
On a local host, such attempts are ignored. 


e@ If you delete a local distribution list, SADMINISTERED_FAMILY and 
$ADMINISTERED _USER are set to the identity of the NOS/VE user 
who owned the distribution list. 
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@ Only the distribution list owner and the Mail/VE administrator can 
delete a distribution list. 


A Mail/VE administrator always has administrator privileges for a 
remote distribution list. To delete a remote distribution list, you must 
specify its address. Neither $ADMINISTERED_FAMILY nor 
$ADMINISTERED_USER change when you delete a remote distribution 
list. 


e If the address specified by the address attribute parameters does not 
uniquely identify a distribution list owned by $ADMINISTERED _ USER, 
the command terminates with an error message. 


@ For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 


Examples The following example deletes a distribution list from the Mail/VE 
directory. 


Admm/delete_distribution_list . 
Admm../distribut ion_!ist_name=’ad_hoc_committee’ 
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DELETE _LETTER 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Examples 


Deletes a letter from a mailbox. 


DELETE _LETTER or 
DELL 
LETTER =integer or string 
STATUS =status variable 
LETTER or L 


Specifies the letter to be deleted. Enter the letter either by letter number 
as an integer, or by letter identifier as a string. 


The letter number is the number assigned to the letter on the letter list. 
The letter list is displayed when you enter the LIST_MAIL subcommand. 
It can change each time you use LIST_MAIL. The letter identifier is 
permanently assigned to the letter by Mail/VE when it is delivered to the 
mailbox. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


@ Only the mailbox owner and the Mail/VE administrator can delete 
letters from a mailbox. 


@ Deleting letters does not affect the letter list assembled by LIST_MAIL 
or the value of $LETTER. 


e If no letter corresponds to the letter number or letter identifier, you 
receive an error message. 


The following example deletes letter number 1 in the letter list. 
Admm/delete_letters letter=1 
This example deletes the letter using its letter identifier (GW14). 


Admm/delete_letters letter=’GW14’ 
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DELETE _MAILBOX 
ADMM Subcommand 


Purpose Deletes a mailbox and the contents of the mailbox belonging to the 
$ADMINISTERED _USER. 


Format DELETE _MAILBOX or 
DELM 
PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
STATUS =status variable 


Parameters PERSONAL_ NAME or PN 


Specifies the name of the mailbox to delete. Enter the name as a 1- 
through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you enter the unit names is significant; address lookup procedures 
determine a match based on the order. 

ORGANIZATION _NAME or ON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 
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Remarks © Only the mailbox owner and the Mail/VE administrator can delete a 
mailbox. 


@ If you delete a local mailbox, $ADMINISTERED_FAMILY. and 
S$ADMINISTERED _USER are set to the identity of the NOS/VE user 
who owned the mailbox. There is no change to $ADMINISTERED _ 
USER or $ADMINISTERED _FAMILY if you delete a remote mailbox. 


© For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 
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DELETE _ORGANIZATION 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 
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Deletes an organization entry from the Mail/VE directory. 


DELETE _ORGANIZATION or 

DELO 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
TITLE =string 
STATUS =status variable 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units. Enter each unit as a 
1- through 32-character string. The order in which you enter the unit 
names must be the same order you specified when you created the 
organization. 


ORGANIZATION _NAME or ON 
Specifies the name of the organization to delete. Enter the name as a 1- 
through 64-character string. 


TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the 
destination mail service. Enter the name as a 1- through 32-character 
string. 


The default is the local MTA name returned by the $MAILVE _ 
INSTALLATION function. 

STATUS 

Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


Although all parameters for this subcommand are optional, you must 
specify a value for either the organization units or the organization name 
parameter to identify the organization entry you want to delete. 
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DELETE _ROUTE 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Deletes a route entry from the Mail/VE directory. 


DELETE _ROUTE or 

DELR 
TITLE = string 
COUNTRY =string 
ADMINISTRATIVE _DOMAIN =string 
PRIVATE _DOMAIN =string 
STATUS =status variable 


TITLE or T 


Specifies the message transfer agent (MTA) name assigned to the 
destination mail service. Enter the name as a 1- through 32-character 
string. 


COUNTRY or C 


Specifies the country code of the destination mail service. Enter the code 


as a 1- through 3-character string. See appendix C for the list of countries 
and their associated codes. . 

ADMINISTRATIVE _DOMAIN or AD 

Specifies the administrative domain of the destination mail service. Enter 
the domain as a 1- through 16-character string. 

PRIVATE __DOMAIN or PD | 

Specifies the private domain of the destination mail service. Enter the 
domain as a 1- through 16-character string. 

STATUS | | 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 

The DELETE_ROUTE subcommand can be used only by users whose 
MAILVE _ADMINISTRATION validation level is set to ANALYST. If you 
are deleting XTF routes, you must have a permit to the XTF configuration 


file. For additional information, see General Configuration Procedure: Using 
NOS/VE and Other X.400 Hosts in chapter 2. 
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DELETE _USER 
ADMM Subcommand 


Purpose Deletes one or more user entries from the Mail/VE directory. When a user 
is deleted, all the user's mailboxes, distribution lists, and letters are also 
deleted. If the MAILVE_ADMINISTRATION level of the user is set to 
NONE, the user can no longer access Mail/VE. 


Format DELETE _USER or 
DELU 
USER =list of name 
FAMILY = name 
STATUS =status variable 
Parameters USER or U 


Specifies the NOS/VE user name(s) to delete from the Mail/VE directory. 


FAMILY or F 


Specifies the name of the NOS/VE family to which the user or users 
belong. 


STATUS 
Special attributes: BY_NAME 


Specifies the completion status for this subcommand. 


Remarks @ Neither $ADMINISTERED_FAMILY nor $ADMINISTERED_USER are 
referenced or changed by this command. 


@ To delete users, you must be the users’ administrator. For example, a 
user whose MAILVE_ADMINISTRATION is set to FAMILY can delete 
only users in the same family. 
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DISPLAY_DEFAULT_GATEWAY_ADDRESS 
ADMM Subcommand 


Purpose Displays the X.400 address of the default Mail/VE gateway. Mail/VE uses 
the address when a user enters an RFC822-formatted address as the 
recipient of a letter but does not enter the X.400 address of the Mail/VE 
gateway to reach that recipient. 


: Format DISPLAY _DEFAULT_GATEWAY ADDRESS or 
: DISDGA 

OUTPUT =file 

STATUS =statius variable 


Parameters OUTPUT or O 
Special attributes: BY_ NAME © 
Specifies the file to which the display is written. 
The default is the output file specified on the ADMINISTER_MAIL 
command. 
STATUS 
Special attributes: VAR, BY_NAME | 
Specifies the completion status for this. subcommand. 


: Examples The following example displays the X.400 address of the default Mail/VE 
gateway. 


Admm/disdga 

Organization units: MGARH 
Organization name: 

Private domain: ARH 
Administrative domain: ATTMAIL 
Country: US 
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DISPLAY_DISTRIBUTION _LIST 
ADMM Subcommand 


Purpose Displays information about one or more distribution lists owned by a 
specific user. 


Format DISPLAY_DISTRIBUTION _LIST or 
DISDL 
DISTRIBUTION _LIST_NAME=keyword or record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
DISPLAY _OPTIONS =keyword 
OUTPUT =file 
STATUS =status variable 


Parameters DISTRIBUTION __LIST_NAME or DLN 


Specifies the name of the distribution list to display. Enter the keyword 
ALL to display all distribution lists of the default user. Otherwise, enter 
the distribution list name as a 1- through 64-character string or as a 
record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as a 1- through 32-character string. The 
order in which you enter the unit names is significant; address lookup 
procedures determine a match based on the order. 


ORGANIZATION __NAME or ON 


Specifies the name of the organization associated with the distribution list. 
Enter the name as a 1- through 64-character string. 
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DISPLAY __OPTIONS or DISPLAY _OPTION or DO 
Special attributes: BY_NAME 
Specifies the information to be displayed. Enter one of the following 
keywords. 
BRIEF or B 
Displays only local address attributes of the distribution list, the 
distribution list type, and the expand attribute. 
CONTENTS or C 
Displays the address list. 


FULL or F 
Displays all distribution list attributes. 


PERMITS or PERMIT or P 


Displays only the type of permit. For group distribution lists, displays 
the list of distribution lists with READ or USE privilege. 


The default is the keyword BRIEF. 


OUTPUT or O 
Special attributes: BY_NAME 
Specifies the file to which the display is written. 
The default is the output file specified on the ADMINISTER_MAIL 
command. 
_ STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


Remarks @ If you omit the address parameters, you are prompted for the 
DISTRIBUTION _LIST_NAME parameter. 


@ If you display a local distribution list, $ADMINISTERED_FAMILY and 
$ADMINISTERED _USER are set to the identity of the NOS/VE user 
who owns the distribution list. 


© A Mail/VE administrator always has administrator privileges for a 
remote distribution list. To display a remote distribution list, you must 
specify its address. Neither $ADMINISTERED_FAMILY nor 
$ADMINISTERED _USER changes when you display a remote 
distribution list. 
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Examples This example asks for a brief display of a distribution list. 


Admn/display_distribution_list 
Admm. ./distribut ion_list_name=’project_members’ 


The following example requests a display of all the addresses in the 
distribution list. 


Admm/display_distribution_list 
Admm. ./distribut ion_list_name=’project_members’.. 
Admn. ./display_opt ions=contents 
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DISPLAY_MAILBOX 
ADMM Subcommand 


Purpose Displays information about one or more mailboxes owned by 
$ADMINISTERED _USER or a single mailbox specified by the 
PERSONAL _NAME parameter. 


Format DISPLAY_MAILBOX or 
DISM 
PERSONAL __NAME=keyword or record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
DISPLAY _OPTIONS = keyword 
OUTPUT =file 
STATUS =status variable 


Parameters PERSONAL NAME or PN 


Specifies the name of the mailbox to display. Enter the keyword ALL to 
display all mailboxes of the default user. Otherwise, enter the mailbox 
name as a 1- through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you enter the unit names is significant; address lookup procedures 
determine a match based on the order. 


ORGANIZATION _NAME or ON 


Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 
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DISPLAY _OPTIONS or DISPLAY _OPTION or DO 
Special attributes: BY_NAME 
Specifies the information to be displayed. Enter one of the following 
keywords. 
BRIEF or B 


Displays only local address attributes. 


FULL or F 
- Displays all mailbox attributes. 


PERMITS or PERMIT or P 


Displays only the type of permit. For group mailboxes, display the list 
of mailboxes with read or write privilege. 


The default is the keyword BRIEF. 


OUTPUT or O 
Special attributes: BY NAME 
Specifies the file to which the display is written. 
The default is the output file specified on the ADMINISTER_MAIL 
command. 
STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 
Remarks © If you display a local mailbox by specifying the PERSONAL_NAME 


parameter, $ADMINISTERED_FAMILY and $ADMINISTERED _USER 
are set to the identity of the NOS/VE user who owns the mailbox. 


© A Mail/VE administrator always has administrator privileges for a 
remote mailbox. To display a remote mailbox, you must specify its 
address. Neither $ADMINISTERED _FAMILY nor $ADMINISTERED _ 
USER change when you display a remote mailbox. 
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DISPLAY_ORGANIZATIONS | 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Displays one or more organizations registered in the Mail/VE address 
directory. 


DISPLAY_ORGANIZATIONS or 
DISPLAY_ORGANIZATION or © 
DISO 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
DISPLAY _OPTIONS = keyword 
FORMAT =keyword . 
OUTPUT =file 
STATUS =status variable 
ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units to display: Enter each 
unit as a 1- through 32-character string. The order in which you enter the 
unit names is significant; address lookup procedures determine a match 
based on the order. 

ORGANIZATION _NAME or ON | 

Specifies the name of the organization to display. Enter the name as a 1- 
through 64-character string. 

DISPLAY OPTIONS or DISPLAY _OPTION or DO 

Special attributes: BY_NAME 

Specifies the information to display. Enter one of the following keywords. 


ALL 


Displays all organizations registered in the directory. 


LOCAL or L 


Displays only organizations that reside on this host. 


NON _LOCAL or NL 
Displays only organizations that reside on remote hosts. 
The default is the keyword LOCAL. 


FORMAT or F 
Special attributes: BY_NAME 
Specifies the format for the display. Enter one of the following keywords. 


DEFINITION or D 


Displays the organization information in a labeled format. 


SOURCE or S 


Displays the organization information as a list of CREATE _ 
ORGANIZATION subcommands. 


The default is the keyword DEFINITION. 
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OUTPUT or O 

Special attributes: BY_NAME 

Specifies the file to which output is written. 

The default is the output file specified on the ADMINISTER_MAIL 
command. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


Remarks If a user omits all parameters (other than OUTPUT), the display lists all 
local organizations. 
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DISPLAY_ROUTES 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Displays the contents of the route directory. 


DISPLAY_ROUTES or 
DISPLAY_ROUTE or 
DISR 
TITLE =string 
COUNTRY =string | . 
ADMINISTRATIVE _DOMAIN =string 
PRIVATE _DOMAIN =string 
FORMAT =keyword 
OUTPUT =file 
STATUS =status variable 


TITLE or T 

Specifies the message transfer agent (MTA) name of route entries to 
display. Enter the name as a 1- through 32-character string. 

COUNTRY or C 

Specifies the country code of route entries to display. Enter the code as a 
1- through 3-character string. See appendix C for the list of countries and 
their associated codes. 

ADMINISTRATIVE _DOMAIN or AD 

Specifies the administrative domain of the route entries to display. Enter 
the domain as a 1- through 16-character string. 

PRIVATE _DOMAIN or PD 

Specifies the private domain of the route entries to display. Enter the 
domain as a 1- through 16-character string. 

FORMAT or F 

Special attributes: BY_NAME 

Specifies the format for the display. Enter one of the following keywords. 


DEFINITION or D 
Displays the route information in a labeled format. 


SOURCE or S 


Displays the route information as a list of CREATE_ROUTE 
subcommands. 


The default is the keyword DEFINITION. 
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OUTPUT or O 

Special attributes: BY_NAME 

Specifies the file to which output is written. 

The default is the output file specified on the ADMINISTER_MAIL 
command. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


Remarks If a user omits all parameters (other than OUTPUT), the display lists all 
routes. 
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DISPLAY_USERS 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Displays the contents of the user directory. 


DISPLAY_USERS or 
DISPLAY_USER or 
DISU 
USER =keyword or list of name 
FAMILY =name 
DISPLAY __OPTIONS = hevuord or list of keyword 
OUTPUT =file 
STATUS =status variable 
USER or U 


Specifies the NOS/VE user names for which information is displayed. Enter 
a list of names or the keyword ALL to display information on all users. 


The default is the keyword ALL. 


FAMILY or F 
Specifies the name of the NOS/VE family to which the users belong. 
The default is the value returned by $ADMINISTERED _FAMILY. 


DISPLAY _OPTIONS or DISPLAY _OPTION or DO 
Special attributes: BY _NAME 
Specifies the amount of information to display. Enter the keyword ALL to 
display all information about the specified Mail/VE user or enter one or 
more of the following keywords: 

DEFAULT_MAILBOX or DM 


Displays the default mailbox of the specified user. 


NAME or N 
Displays the the user and family names of the specified users. 


OWNED_ENTITIES or OE 
Displays the mailboxes and distribution lists owned by the specified 
user. 
STATISTICS or S 
Displays the mail usage statistics for the specified user. 
The default is the keyword ALL. 


OUTPUT or O 

Special attributes: BY_ NAME 

Specifies the file to which output is written. 

The default is the output file specified on the ADMINISTER_MAIL 
command. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 
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Remarks If you specify the DISPLAY_USER subcommand, $ADMINISTERED _ 
FAMILY is set to the name of the NOS/VE family from which user 
information is being displayed, and $ADMINISTERED_USER is set to the 
NOS/VE user name of the last user for which a display was produced. 
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END _ADMINISTER _MAIL 
ADMM Subcommand 


Purpose Stops an ADMINISTER _MAIL utility session. 


Format END _ADMINISTER _MAIL or 
ENDAM or 
END or 
QUIT or 
QUI 
STATUS =status variable 


Parameters STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


Beets ae 
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LIST_MAIL 
ADMM Subcommand 


Purpose 


Format 


Parameters 


60464515 C 


Displays the number of letters in one or more mailboxes owned by the 
$ADMINISTERED_USER, or a numbered list of letters for one mailbox 
identified by address. 


LIST_MAIL or 

LISM or 

LIST 
PERSONAL _NAME=keyword or record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
MAIL _OPTIONS =keyword or list of keyword 
DISPLAY _OPTIONS = keyword 
OUTPUT =file 
STATUS =status variable 


PERSONAL _NAME or PN 


Specifies the name of the mailbox for which you want to display a letter 
list. Enter the keyword OWNED to display the mailboxes owned by the 
S$ADMINISTER_USER. Otherwise, enter the mailbox name as a 1- through 
64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 
The default is all owned mailboxes for the $ADMINISTERED_USER. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 


ORGANIZATION _NAME or ON 
Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 


MAIL __OPTIONS or MAIL __OPTION or MO 


Specifies the type of letters to be included in the letter list. You can enter 
ALL or one or more keywords options for each type. 


If you select more than one option for a type, all of your selections apply. 
If you select all of the options for any type, the effect is the same as if 
you had selected none of the options for that type. 
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Letter types: . 
If you do not select any letter type options, all letters are listed. . 


LETTER or L | 
Includes letters. 


RECEIPT or R 
Includes messages generated upon receipt or nonreceipt of.a letter. 
Read Status types: 
These options apply only to owned mailboxes. 
-SEEN or S 
Includes letters that were previously displayed using READ_LETTER. 
UNSEEN or US 


Includes letters that have not been displayed. 
Sensitivity options: 


PRIVATE or PR 
Includes letters that the sender classified as private. 


PERSONAL or PE 
Includes letters that the sender classified as personal. 


CONFIDENTIAL or CO 
Includes letters that the sender classified as confidential. 
Receipt Certification types: 


CERTIFIED or C 


Includes letters that the sender classified as certified. 


UNCERTIFIED or UC 
Includes letters that are not classified as uncertified. 


Importance types: 


LOW_IMPORTANCE or LI 


Includes letters that the sender classified low importance. 


NORMAL_IMPORTANCE or NI 


Includes letters that the sender classified normal importance. 


HIGH _IMPORTANCE or HI 
Includes letters that the sender classified high importance. 
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Delivery Priority types: 
NORMAL PRIORITY or NP 


Includes letters that the sender classified for normal delivery. 


URGENT _PRIORITY or UP 


Includes letters that the sender classified for urgent delivery. 


NON _URGENT_PRIORITY or NUP 
Includes letters that the sender classified for nonurgent delivery. 
Other types: 


REPLY_REQUESTED or RR 
Includes letters for which the sender requested a reply. 


AUTOFORWARDED or A 


Includes letters that were autoforwarded to the mailbox for which the 
letter list is being produced. 


The default is the keyword UNSEEN if you own the mailbox. Otherwise, 
the default is the keyword ALL. 


DISPLAY _OPTIONS or DISPLAY __OPTION or DO 
Special attributes: BY_NAME 


Specifies the information that appears in the letter list display. Enter one 
of the following keywords: 


BRIEF or B 


Displays a one-line description of each letter that specifies the date/time 
received, the sender's mailbox name (truncated when necessary), the 
length in bytes, and a flag if the letter has high importance or a reply 
is requested. 


FULL or F 


Displays a multiline description of each letter that specifies the letter 
identifier, the date/time received, the sender's mailbox name and 
organization, the subject, the length of the letter in bytes, and a flag if 
the letter has high importance or a reply is requested. 


The default is BRIEF. 


OUTPUT or O 

Special attributes: BY_ NAME 

Specifies the file to which the display is written. 

The default is the output file specified on the ADMINISTER_MAIL 
command. 

STATUS 

Special attributes: VAR, BY_ NAME 


Specifies the completion status for this subcommand. 
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Remarks @ If the mailbox specified does not contain any mail that meets the mail 


option criteria, the letter list is empty. 


e@ Ifa mailbox address is specified, $ADMINISTERED_USER changes to 
the owner of that mailbox. 


Examples The following example checks the $ADMINISTERED_USER default 
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mailbox for unseen mail. 


Admm/list_mail $default_mai1lbox.personal_name 
Hanson, Tyler contains the following letters: 
1.  1989-07-31.11:12:45 Johnson, Gar NOS/VE interfa 474 


The following example displays a brief listing showing the receipts in a 
mailbox. 


Admm/list_mail “Tyler Hanson’ 

Admm ../mail_options=receipt 

Admm ../display_opt ion=brief 

Mailbox ’Tyler Hanson’ contains 2 letters. 
06/08/88 15:31:Barnes, Larry:RECEIPT 
06/08/88 10:21:Lang, Emily:RECEIPT 
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LOOKUP_ADDRESS 
ADMM Subcommand 


Purpose Displays information about one or more addresses that meet the search 
criteria specified by the address parameters (PERSONAL_NAME, 
ORGANIZATION _UNITS, and ORGANIZATION __NAME). 


Format LOOKUP_ADDRESS or 
LOOA 

PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
ADDRESS _OPTIONS =keyword or list of keyword 
DISPLAY __OPTIONS =keyword or list of keyword | 
OUTPUT =file 
STATUS =status variable 


Parameters PERSONAL _NAME or DISTRIBUTION _LIST_NAME or PN or DLN 


Specifies the name of the mailbox or distribution list. Enter the name as a 
1- through 64-character string or as a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 
ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
mailbox or distribution list. Enter each unit as a 1- through 32-character 
string. The order in which you specify the unit names is significant; 
address lookup procedures determine a match based on the order. 


ORGANIZATION _NAME or ON 


Specifies the name of the organization associated with the mailbox or 
distribution list. Enter the name as a 1- through 64-character string. 
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ADDRESS _OPTIONS or ADDRESS _OPTION or AO 
Special attributes: BY_NAME 


Specifies keywords to control the search operation. Enter the keyword ALL 
to display all types of addresses (distribution lists and group, public, and 
private mailboxes) or specify one or more of the following keywords: 


DISTRIBUTION _LIST or DL 
Displays only distribution lists. 


GROUP or G 


Displays only group mailboxes and distribution lists. 


MAILBOX or M 


Displays only mailboxes. 


PRIVATE or PR 


Displays only private mailboxes and distribution lists. 


PUBLIC or PU 
Displays only public mailboxes and distribution lists. 


The default is the keyword ALL. 


DISPLAY __OPTIONS or DISPLAY _OPTION or DO 
Special attributes: BY_NAME 


Specifies the amount of information to display. Enter the keyword ALL to 
display all information about the address or specify one or more of the 
following keywords: 


ALIAS _NAME or AN 


Displays the alias name or names of the mailbox or distribution list, if 
any, for each address. 


DESCRIPTION or D 


Displays the description, if any, for each address. 


ORGANIZATION __NAME or ON 


Displays the organization name, if any, for each address. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 
Displays the organization units, if any, for each address. 


PERSONAL_NAME or PN 


Displays the primary mailbox or distribution list name for each 
address. 


TELEPHONE _NUMBER or TN 
Displays the telephone number, if any, for each address. 
The default is the keyword PERSONAL_NAME. 
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OUTPUT or O 
Special attributes: BY_NAME 
Specifies the file to which output is written. 


The default is the output file specified on the ADMINISTER_MAIL 
command. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


Remarks © 
t 
e 
C] 
e 
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At least one of the addressing parameters (PERSONAL_NAME, 


- ORGANIZATION _UNITS, and ORGANIZATION _NAME) must be 


specified. For detailed information on specifying Mail/VE addresses, see 
chapter 2 of the Mail/VE Version 2 Usage manual. 


The wildcard character * can indicate parts of the address not specified. 
For information on using the wildcard character in address searches, 
see Mail/VE Version 2 Usage manual. 


The search is not case-sensitive. That is, searching for Ziggy finds 
ziggy, ZIGGY, Ziggy, and so on. 


A LOOKUP_ADDRESS search can handle up to 500 addresses at a 
time. If the search criteria are so broad that the search identifies more 
than 500 addresses, the search terminates. 


You can change the retention period to any value. The validation limits 
of the $ADMINISTERED_USER are not enforced. 
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RETAIN _LETTER 
ADMM Subcommand 


Purpose Changes the length of time before a letter in the current letter list is 
deleted from the mail system. The length of time is called the retention 
period. 

Format RETAIN _LETTER or 
RETL 


LETTER =keyword or integer or string 
DAYS =keyword or integer 
STATUS =status variable 

| Parameters LETTER or L 


Specifies the letter for which the retention period is to be changed. Identify 
the letter by letter identifier, letter number, or keyword. 


The letter number is the number assigned to the letter on the letter list 
generated when you enter the LIST_MAIL subcommand. This number is 
subject to change each time you use LIST_MAIL. The letter identifier is 
permanently assigned to the letter by Mail/VE when it is delivered to the 
mailbox. Enter one or more of the following keywords: 


CURRENT or C 


Selects the current letter from the letter list. (The current letter is the 
letter most recently displayed.) 


FIRST or F 

Selects the first letter in the letter list. 

NEXT or N 

Selects the letter following the current letter in the letter list. 


LAST or L 
Selects the last letter in the letter list. 


PREVIOUS or P 
Selects the letter preceding the current letter in the letter list. 
The default is the keyword CURRENT. 


DAYS or DAY or D 
Special attributes: BY_NAME 


Specifies the retention period as the number of days (1 to 365) from today 
to retain the letter in the mailbox. If the keyword MAXIMUM is specified, 
the retention period is the maximum retention period supported by 
Mail/VE (approximately 99 years). 


The default is MAXIMUM. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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@ If the letter you specify on the LETTER parameter is not in the letter 
list or has been deleted, Mail/VE displays an error message. 


@ The $LETTER function always returns the value of the letter last 
displayed (called the current letter). 


@e The NOS/VE system administrator sets retention period limits for each 
user. The Mail/VE administrator uses the RETAIN _LETTER 
sucommand to change the retention period to any value. The validation 
limits installed for the $ADMINISTERED_USER are not enforced. 


The following example changes the retention period of letter number 7 in 
the current letter list to 14 days from today: 


Admm/retain_letter letter=7 days=14 


This example changes the retention period of the current. letter in the 
letter list to 10 days from today: 


Admm/retain_letter days=10 
This example increases the retention period of the letter with letter 
identifier JA42 to the maximum number of days the user is allowed to 


retain letters: 


Admm/retain_letter letter=’ ja42’ 
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SELECT _LETTER 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 


Specifies the value returned when you use the $LETTER function. 


SELECT_LETTER or 

SELL 
LETTER =keyword or integer or string 
STATUS =status variable 

LETTER or L | 


Specifies the letter to be selected and makes it the current letter. The 
value returned when you use the $LETTER function is set to the letter 
identifier of the letter selected. Enter a letter number, letter identifier, or 
keyword. 


The letter number is the number assigned to the letter on the letter list. 
It can change each time you enter the LIST_MAIL subcommand. The 
letter identifier is permanently assigned to the letter by Mail/VE when it 
is delivered to the mailbox. | 


The following keyword options are available: 


CURRENT or C 


Selects the current letter from the letter list. (The current letter is the 
letter most recently displayed.) 


FIRST or F 
Selects the first letter in the letter list. 


NEXT or N 
Selects the letter following the current letter in the letter list. 


LAST or L 
Selects the last letter in the letter list. 


PREVIOUS or P 
Selects the letter preceding the current letter in the letter list. 
The default is NEXT. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


@ If no letter list exists or the specified letter is not included in the 
letter list, Mail/VE displays an error message. 


e@ If no letter is selected, an empty string is returned when you use the 
$LETTER function. 
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SELECT_USER 
ADMM Subcommand 


Purpose 


Format 


Parameters 


Remarks 
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Changes the values returned by the $ADMINISTERED_FAMILY and 
$ADMINISTERED _USER functions. 


SELECT_USER or 


SELU 
USER =name 
FAMILY =name 


STATUS =status variable 


USER or U 
Specifies the NOS/VE user name to assign to $ADMINISTERED _USER. 


FAMILY or F 

Specifies the NOS/VE family name to assign to $ADMINISTERED _ 
FAMILY. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 

Only users whose MAILVE ADMINISTRATION validation level is set to 
ANALYST, SYSTEM, or FAMILY can assign a value to 
S$ADMINISTERED _FAMILY. Users whose MAILVE_ADMINISTRATION 


level is set to FAMILY can assign only the name of their family on the 
FAMILY parameter. 


ADMINISTER_MAIL Utility 5-47 


Mailbox and Distribution List Subutility Subcommands 


Mailbox and Distribution List Subutility Subcommands 


= To use the subcommands described in this section, you must be in one of the following 
subutilities: CHANGE _DISTRIBUTION _LIST, CHANGE_MAILBOX, CREATE _ 
DISTRIBUTION _LIST, or CREATE MAILBOX. The subcommands with which you 
initiate these subutilities have the same names as the utilities and are described 
earlier in this chapter. The following table summarizes the subutilities and their 
applicable subcommands. 


Subutility/Subcommand Prompt Applicable Subcommands 


CHANGE _DISTRIBUTION _LIST Chadl/ ADD_ADDRESS 
ADD_PERMISSION 
DELETE _ADDRESS 
DELETE _PERMISSION 
DISPLAY_ADDRESS_ LIST 
DISPLAY_ATTRIBUTES 

- DISPLAY_PERMISSIONS 

END_CHANGE _DISTRIBUTION _ 
LIST! 
SET_ATTRIBUTES 


CHANGE _MAILBOX : Cham/ ADD_PERMISSION 
DELETE _PERMISSION 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 
END_CHANGE _ MAILBOX! 
SET_ATTRIBUTES 


CREATE _DISTRIBUTION _LIST Credl/ ADD_ADDRESS 
ADD_PERMISSION 
DELETE _ADDRESS 
DELETE _PERMISSION 
DISPLAY_ADDRESS _LIST 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 
END _CREATE _DISTRIBUTION _ 
LIST! 
SET_ATTRIBUTES 


1. These subcommands stop the applicable subutility. 
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Subutility/Subcommand Prompt Applicable Subcommands 


CREATE _ MAILBOX Crem/ ADD _PERMISSION 
DELETE _PERMISSION 
DISPLAY_ATTRIBUTES 
DISPLAY_PERMISSIONS 
END_CREATE _MAILBOX? 
SET_ATTRIBUTES | 


The subcommands are listed in alphabetical order. The line under the subcommand 
name lists the ADMINISTER_MAIL subcommands that call the subutilities in which 
you can use that subcommand: For example: . 


ADD _ADDRESS 
‘CHADL and CREDL Subcommands_ 


means that you can use the ADD_ADDRESS subcommand while in the CHADL and 
CREDL subutilities. 


2. These subcommands stop the applicable subutility. 


60464515 C ADMINISTER_MAIL Utility 5-49 


Mailbox and Distribution List Subutility Subcommands 


ADD _ADDRESS 
CHADL and CREDL Su heommands 


Purpose 


Format 


Parameters 


Adds an address to a distribution list. 


ADD_ADDRESS or | 


ADDA 
PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN = string 
COUNTRY =string 
UA _IDENTIFIER =string 
TERMINAL _IDENTIFIER ene 

-X121 ADDRESS =string 

DOMAIN _DEFINED _ATTRIBU TES = list of pevokd 
POSTAL _ADDRESS =list of string 
POSTAL __ADDRESS _COUNTRY _NAME =string 
POSTAL _ADDRESS _CODE =string 
STATUS =status variable 


PERSONAL _NAME or DISTRIBUTION _LIST or PN or DLN 


Specifies the name of the mailbox or distribution list to add to the 
distribution list. Enter the name as a 1- through 256-character string or a 
record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox or distribution list. Enter each unit as a 1- through 32-character 
string. The order in which you specify the unit names is significant; 
address lookup procedures determine a match based on the order. 
ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox or 
distribution list. Enter the name as a 1- through 64-character string. 
PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 


Specifies the private domain of the mailbox or distribution list. Enter the 
domain as a 1- through 16-character string. 
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ADMINISTRATIVE _DOMAIN or AD 
Special attributes: BY_NAME, ADVANCED 


Specifies the administrative domain of the mailbox or distribution list. 
Enter the domain as a 1- through 16-character string. 


COUNTRY or C 

Special attributes: BY_NAME, ADVANCED 

Specifies the country code of the mailbox or distribution list. Enter the 
code as a 1- through 3-character string. See appendix C for the list of 
countries and their associated codes. 

UA __IDENTIFIER or UI 

Special attributes: BY_NAME, ADVANCED 

Specifies the user agent (UA) identifier of the mailbox or distribution list. 
The UA identifier must be unique within the specified domain. Enter a 
string of 1 through 32 characters. 

TERMINAL _IDENTIFIER or TI 

Special attributes: BY_NAME, ADVANCED 

Specifies the terminal identifier of a telematic terminal on which the mail 
is read. Enter a string of 1 through 24 characters. 

X121_ADDRESS or XA 

Special attributes: BY_NAME, ADVANCED 

Specifies the address specified in accordance with recommendation X.121. 
Enter a string of 1 through 15 characters composed of the digits 0 
through 9. 

DOMAIN _DEFINED _ATTRIBUTES or DDA 

Special attributes: BY_ NAME, ADVANCED 

Specifies a list of one through four non-X.400 attributes of the address. 
Enter each attribute as a record of the following format: 


record 
name: string 1..8 
value: string 1..128 
recend 


POSTAL _ADDRESS or PA 


Special attributes: BY_NAME, ADVANCED 


Specifies information that describes the physical postal delivery system of 
the address. Enter the information with a list of 2 through 6 strings of 
1 through 30 characters each. 


POSTAL _ADDRESS COUNTRY _NAME or PACN 
Special attributes: BY_NAME, ADVANCED 


Specifies the postal address country name of the address. Enter a string of 
1 through 30 characters. 
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POSTAL __ADDRESS _CODE or PAC 

Special attributes: BY_NAME, ADVANCED 

Specifies the postal address code of the address. Enter a string of 
1 through 128 characters. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


Remarks e If you add a BITNet or Internet address to a distribution list, use the 
PERSONAL_NAME parameter with a commercial at sign (@): 


personal _name=’ jdsmith@xyz.abc.com’ 


The commercial at sign distinguishes a BITNet or Internet address 
from an X.400 (Mail/VE) address. 


@ Addresses are added to a distribution list exactly as they are entered. 
No verification or validation of any form occurs. 


e You cannot use the wildcard character (*) in address parameters. 


e For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 


Examples The following example adds two addresses to an existing distribution list. 


Admm/change_distribution_list .. 
Admm. ./’ Technical_Review_Board’ 
Chad!/add_address ‘Ellen Gray’ 
Chadi/add_address ’Malcolm Boswell’ 
Chad1/end_change_distribution_list 
Admm/ 
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ADD _PERMISSION 
CHADL, CHAM, CREDL, and CREM Subcommands 


Purpose 


Format 


Parameters 
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Adds an address to the list of addresses permitted to use the group 
mailbox or distribution list. 


ADD _PERMISSION or 

ADDP 
PERSONAL _NAME= record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
PERMISSIONS =keyword or list of keyword 
STATUS =status variable 


PERSONAL _NAME or PN 


Specifies the name of the mailbox permitted to use this group mailbox or 
group distribution list. Enter the name as a 1- through 256-character 
string or as a record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 


Specifies the private domain of the mailbox. Enter the domain as a 1- 
through 16-character string. 


-ADMINISTRATIVE _DOMAIN or AD 


Special attributes: BY_NAME, ADVANCED 


Specifies the administrative domain of the mailbox. Enter the domain as a 
1- through 16-character string. 
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COUNTRY or C 
Special attributes: BY_NAME, ADVANCED 
Specifies the country code of the mailbox. Enter the code as a 
1- through 3-character string. See appendix C for the list of countries and 
their associated codes. 
PERMISSIONS or P 
Special attributes: BY_NAME 
Specifies the access permitted to the mailbox. Enter the keyword ALL or 
specify one or more of the following keywords. Specifying ALL establishes 
READ and WRITE permission for mailboxes and READ and USE 
permission for distribution lists. 
READ or R 
For mailboxes, letters can be read; for distribution lists, the list can be 
displayed. 
WRITE or W 


For mailboxes only. Letters can be sent to the mailbox. 


USE or U 


For distribution lists only. Distribution lists can be included in a 
recipient list. However, without READ access, users cannot expand the 
distribution list. 


The default is the keyword ALL. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


© Addresses are added to a distribution list exactly as they are entered. 
No verification or validation of any form occurs. 


e@ The wildcard character (*) can indicate parts of the address not 
specified. 


© For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 
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DELETE _ADDRESS 
CHADL and CREDL Subcommands 


Purpose Adds an address to a distribution list. 
Format DELETE _ADDRESS or 
DELA 


PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 

PRIVATE _DOMAIN =string 

ADMINISTRATIVE _DOMAIN =string 

COUNTRY =string 

UA _IDENTIFIER =string 

TERMINAL _IDENTIFIER =string 

121 ADDRESS =string 

DOMAIN _DEFINED _ATTRIBUTES =list of record 
POSTAL _ADDRESS =list of string 

POSTAL _ADDRESS _COUNTRY _NAME =string 
POSTAL _ADDRESS _CODE =string 

STATUS =status variable 


Parameters PERSONAL _NAME or DISTRIBUTION _LIST or PN or DLN 


Specifies the name of the mailbox or distribution list to add to the 
distribution list. Enter the name as a 1- through 256-character string or a 
record of the following format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 


ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 


Specifies the list of one to four organization units associated with the 
mailbox or distribution list. Enter each unit as a 1- through 32-character 
string. The order in which you specify the unit names is significant; 
address lookup procedures determine a match based on the order. 


ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox or 
distribution list. Enter the name as a 1- through 64-character string. 
PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 


Specifies the private domain of the mailbox or distribution list. Enter the 
domain as a 1- through 16-character string. 
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ADMINISTRATIVE _DOMAIN or AD 

Special attributes: BY_NAME, ADVANCED 

Specifies the administrative domain of the mailbox or distribution list. 
Enter the domain as a 1- through 16-character string. 

COUNTRY or C 

Special attributes: BY_NAME, ADVANCED 

Specifies the country code of the mailbox or distribution list. Enter the 
code as a 1- through 3-character string. See appendix C for the list of 
countries and their associated codes. 

UA _IDENTIFIER or UI 

Special attributes: BY_NAME, ADVANCED 

Specifies the user agent (UA) identifier of the mailbox or distribution list. 
The UA identifier must be unique within the specified domain. Enter a 
string of 1 through 32 characters. 

TERMINAL _IDENTIFIER or TI 

Special attributes: BY_NAME, ADVANCED 

Specifies the terminal identifier of a telematic terminal on which the mail 
is read. Enter a string of 1 through 24 characters. 

X121_ADDRESS or XA 

Special attributes: BY_NAME, ADVANCED 


Specifies the address specified in accordance with recommendation X.121. 
Enter a string of 1 through 15 characters composed of the digits 
0 through 9. 


DOMAIN _DEFINED _ATTRIBUTES or DDA 
Special attributes: BY_NAME, ADVANCED 
Specifies a list of one through four non-X.400 attributes of the address. 


Enter each attribute as a record of the following format: 


record 
name: string 1..8 
value: string 1..128 
recend 


POSTAL _ADDRESS or PA 

Special attributes: BY_NAME, ADVANCED 

Specifies information that describes the physical postal delivery system of 
the address. Enter the information with a list of 2 through 6 strings of 

1 through 30 characters each. 

POSTAL _ADDRESS _COUNTRY_NAME or PACN 

Special attributes: BY_NAME, ADVANCED 


Specifies the postal address country name of the address. Enter a string of 
1 through 30 characters. 
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POSTAL __ADDRESS _CODE or PAC 

Special attributes: BY_LNAME, ADVANCED 

Specifies the postal address code of the address. Enter a string of 
1 through 128 characters. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 


The following example deletes an address from an existing distribution list. 


Admm/change_distribution list ’Photo_Club_News’ 
Chad|l/delete_address ’Mary Parker’ .. 
Chad1../organizat ion_name=’Public Relations’ 
Chad!/end_distribution_list 

Admm/ 
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DELETE _PERMISSION 
CHADL, CHAM, CREDL, and CREM Subcommands 


Purpose 


Format 


Parameters 


Deletes a mailbox address from the list of mailboxes permitted to use the 
distribution list or mailbox you are changing or creating. This subcommand 
applies only to group mailboxes and distribution lists. 


DELETE _PERMISSION or 

DELP 
PERSONAL _NAME=record or string 
ORGANIZATION _UNITS =list of string 
ORGANIZATION _NAME =string 
PRIVATE _DOMAIN =string 
ADMINISTRATIVE _DOMAIN =string 
COUNTRY =string 
STATUS =status variable 


PERSONAL _NAME or PN 


Specifies the name of the mailbox permitted to use this group mailbox or 
group distribution list. Enter the name as a 1- through 256-character 
string or as a record of the following format: 


record 
surname: string 1..40 
Given name: string 0..16 
initiats: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
mailbox. Enter each unit as a 1- through 32-character string. The order in 
which you specify the unit names is significant; address lookup procedures 
determine a match based on the order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

PRIVATE _DOMAIN or PD 

Special attributes: BY_NAME, ADVANCED 

Specifies the private domain of the mailbox. Enter the domain as a 1- 
through 16-character string. 

ADMINISTRATIVE _DOMAIN or AD 

Special attributes: BY_NAME, ADVANCED 


Specifies the administrative domain of the mailbox. Enter the domain as a 
1- through 16-character string. 
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COUNTRY or C 
Special attributes: BY_NAME, ADVANCED 


Specifies the country code of the mailbox. Enter the code as a 
1- through 3-character string. See appendix C for the list of countries and 
their associated codes. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


Remarks @ The wildcard character (*) can indicate parts of the address not 
specified. 


e@ For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 


Examples The following example deletes two mailbox addresses from the list of 
permissions for a group mailbox. 


Admm/change_mailbox .. 

Admm. ./’Demo_Log’ 
Chad!/delete_permission ‘Jack Holland’ 
Chadi/delete_permission ’Laura Phillips’ 
Chad1/end_change_mai 1 box 

Admm/ 
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DISPLAY_ADDRESS _LIST 
CHADL and CREDL Subcommands 


Purpose Displays the addresses that make up a distribution list. 


| Format DISPLAY_ADDRESS_LIST or 
: DISAL 
DISPLAY _OPTIONS =keyword 
OUTPUT = file 
STATUS =status variable 
Parameters DISPLAY _OPTIONS or DISPLAY _OPTION or DO 
Special attributes: BY_NAME 
Specifies the information to be displayed. Enter one of the following 
keywords. . 
BRIEF or B 


Displays only local address attributes. 


FULL or F 
Displays all address attributes. 
The default is the keyword BRIEF. 


OUTPUT or O 

Special attributes: BY_NAME 

Specifies the file to which output is written. 

The default is the output file specified on the ADMINISTER MAIL 
command. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 


Remarks © If there are no addresses in the distribution list, the command 
terminates and the system displays an informative message. 


@ For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. 
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DISPLAY _ATTRIBUTES 
CHADL, CHAM, CREDL, and CREM Schcommmauds 


Purpose Displays the attributes of a mailbox or distribution list. 
Format DISPLAY_ATTRIBUTES or 

DISPLAY_ATTRIBUTE or 

DISA 


OUTPUT =file 
STATUS =status variable 


Parameters OUTPUT or O 
Special attributes: BY_NAME 
Specifies the file to which output is written. 
The default is the output file specified on the ADMINISTER _MAIL 
command. 
STATUS 
Special attributes: VAR, BY NAME 
Specifies the completion status for this subcommand. 
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_ DISPLAY_PERMISSIONS 
- CHADL, CHAM, CREDL, and CREM Subcommands 


| Purpose ~ Displays the list of permitted mailboxes for a group mailbox or distribution 
list. 


Format DISPLAY_PERMISSIONS or 
DISPLAY_PERMISSION or 
DISP 
DISPLAY _OPTIONS = keyword 
OUTPUT =file 
STATUS =status variable 
Parameters DISPLAY_OPTIONS or DISPLAY _OPTION or DO 
Specifies the information to be displayed. Enter one of the following 
keywords. 
BRIEF or B 


Displays the address attributes of each permission entry. 


FULL or F 
Displays all of the address attributes and permissions granted. 
The default is the keyword BRIEF. 


OUTPUT or O 

Special attributes: BY_NAME 

Specifies the file to which output is written. 

The default is the output file specified on the ADMINISTER_MAIL 
command. 

STATUS 

Special attributes: VAR, BY_NAME 

Specifies the completion status for this subcommand. 
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END _CHANGE _DISTRIBUTION _LIST 
CHADL Subcommand 


Purpose Stops a CHANGE_DISTRIBUTION _LIST subutility session. 


Format END _CHANGE _ DISTRIBUTION _LIST or 
ENDCDL or 
END or 
QUIT or 
QUI 
SAVE = boolean 
STATUS =status variable 
Parameters SAVE or S 
Specifies whether or not the changes made during this subutility session 
should be saved. 
FALSE 


Changes made during this subutility session are discarded. 


TRUE 
Changes made during this subutility session are saved. 
The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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END _CHANGE _MAILBOX 
CHAM Subcommand 


Purpose Stops a CHANGE _MAILBOX subutility session. 


Format END _CHANGE _MAILBOX or 
ENDCM or 
END or 
QUIT or 
QUI 
SAVE = boolean 
STATUS =status variable 
Parameters SAVE or S 
Specifies whether or not the changes made during this subutility session 
should be saved. 
FALSE 


Changes made during this subutility session are discarded. 
TRUE 
Changes made during this subutility session are saved. 


The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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END _CREATE _ DISTRIBUTION _LIST 
CREDL Subcommand 


Purpose Stops a CREATE_DISTRIBUTION _LIST subutility session. 


Format END __CREATE _DISTRIBUTION _LIST or 
ENDCDL or 
END or 
QUIT or 
QUI 
SAVE = boolean . 
STATUS =status variable 
Parameters SAVE or S 
Specifies whether or not the distribution list created during this subutility 
session is saved. 
FALSE 


The distribution list created during this subutility session is discarded. 


TRUE 
The distribution list created during this subutility session is saved. 
The default is TRUE. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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END _CREATE _MAILBOX 
CREM Subcommand 


Purpose Stops a CREATE_MAILBOX subutility session. 


Format END _CREATE _MAILBOX or 
ENDCM or 
END or 
QUIT or 
QUI 
SAVE = boolean 
STATUS =status variable 
Parameters SAVE or S 
Specifies whether or not the mailbox created during this subutility session 
is saved. 
FALSE 


The mailbox created during this subutility session is discarded. 


TRUE 
The mailbox created during this subutility session is saved. 
The default is TRUE. . 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 
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SET _ATTRIBUTES 
CHADL and CREDL Subcommands 


Purpose 


Format 


Parameters 
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Defines or changes distribution list attributes. 


SET_ATTRIBUTES or 
SET_ATTRIBUTE or 
SETA 
DISTRIBUTION _LIST __NAME =list of keyword or record or string 
ORGANIZATION _UNITS =list of keyword or string 
ORGANIZATION _NAME =string 
DESCRIPTION =string 
TELEPHONE _NUMBER =string 
EXPAND = boolean 
PERMIT _TYPE =keyword 
TITLE =string 
STATUS =status variable 


DISTRIBUTION _LIST_NAME or DLN 


Specifies a list of one through three elements to describe the distribution 
list. The first element of the list is always used in displays. The second 
and third elements are aliases. Each element can be the keyword NO_ 
CHANGE, or a 1- through 64-character string, or a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is specified as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Special attributes: BY_NAME 


Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as the keyword NO_CHANGE or a 1- 
through 32-character string. The order in which you specify the units is 
significant; address lookup procedures determine a match based on the 
order. 


ORGANIZATION __NAME or ON 

Special attributes: BY_NAME 

Specifies the name of the organization associated with the distribution list. 
Enter the name as a 1- through 64-character string. 
DESCRIPTION or D 

Special attributes: BY_NAME 


Specifies a 1- through 64-character string that describes the distribution 
list. 
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TELEPHONE _NUMBER or TN 
Special attributes: BY_NAME 


Specifies the telephone number of the distribution list owner. Enter a 
string of 1 through 32 characters. 


EXPAND or E 
Special attributes: BY_NAME 


Specifies whether or not the distribution list will be expanded when used. 
The EXPAND parameter applies only to distribution lists residing on the 
same host as the sender. Otherwise, no expansion can occur regardless of 
the value of the EXPAND attribute. 


FALSE 

Distribution list is not expanded. The distribution list name is used in 
the letter header. 

TRUE 


_ Distribution list is expanded. The distribution list name is replaced by 
the addresses contained in the distribution list. 


The default is that the parameter value remains set as last specified. 


PERMIT __TYPE or PT 
Special attributes: BY_NAME 
Specifies the type of distribution list permission. Enter one of the following 
keywords: 
GROUP or G 


A group of defined distribution lists can read mail from or send mail to 
the distribution list. To add or delete distribution lists from the group, 
use the EMAIL ADD_PERMISSION and DELETE_PERMISSION 
subcommands. 


PRIVATE or PR 


Only the distribution list owner can read mail from the distribution 
list. Anyone can send mail to the distribution list. 


PUBLIC or PU 
Any user can read mail from or send mail to the distribution list. 


The default for new distribution lists is PRIVATE; the default for existing 
distribution lists is that PERMIT_TYPE remains unchanged. 


TITLE or T 

Special attributes: BY_NAME, HIDDEN | 
Specifies the message transfer agent name (MTA) assigned to the Mail/VE 
installation where this distribution list is defined. The GENERATE _ 
REMOTE UPDATES command uses this parameter to denote the residency 
of distribution lists. When using the CREATE _ DISTRIBUTION _LIST 
subutility, you specify this parameter to show that the distribution list is 
remote. 
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STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


© The DESCRIPTION and TELEPHONE _NUMBER parameters provide 
additional information and are not used in evaluating distribution list 
addresses for uniqueness. . 


® For detailed information on specifying Mail/VE addresses, see chapter 2 
of the Mail/VE Version 2 Usage manual. | 


The following example creates a distribution list. 


Admm/create_distribution_list 

Credi/set_attributes .. 
Credl../distribution_list_name=(’Market_Research’ ’MRDL’) 
Cred!../organizat ion_unit=(’Consumer Surveys’ ‘Interior Products’ ) 
Cred1../telephone_number =’ 402-981-6743’ 
Cred!../expand=faise .. 

Cred!../permit_type=public .. 

Cred!/add_address Barry Fisher’ 

Cred1/add_address Lonnie Merril]’ 

Credl/add_address Shirley Dreckman’ 
Credl/end_create_distribution_list 

Admm/ 


This example changes an address attribute, the organization unit, of an 
existing distribution list. 


Admm/change_distribution_list ’Market_Research’ 
Credl/set_attribute .. 
Credl../organization_unit=(nc,nc, “Home Furnishings’ ) 
Credl/end_change_distribution_list . 
Admm/ 
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SET_ATTRIBUTES 
CHAM and CREM Subcommand 


Purpose 


Format 


Parameters 


Defines or changes mailbox attributes. 


SET_ATTRIBUTES or 

SET_ATTRIBUTE or 

SETA 
PERSONAL _NAME =list of keyword or record or string 
ORGANIZATION _UNITS =list of keyword or string 
ORGANIZATION _NAME =string 
DESCRIPTION =string 
TELEPHONE _NUMBER =string 
RETENTION _PERIOD=keyword or integer 
PERMIT __TYPE=keyword 
TITLE =string 
STATUS =status variable 


PERSONAL _NAME or PN 


Specifies a list of one through three elements to describe the mailbox. The 
first element of the list is always used in displays. The second and third 
elements are aliases. Each element can be the keyword NO_CHANGE, or 
a 1- through 64-character string, or a record in the format: 


record 
surname: string 1..40 
given name: string 0..16 
initials: string 0..5 
generation qualifier: string 0..3 
recend 


If the name is entered as a record, the surname is required and the other 
record elements are optional. 

ORGANIZATION _UNITS or ORGANIZATION _UNIT or OU 

Specifies the list of one to four organization units associated with the 
distribution list. Enter each unit as the keyword NO_CHANGE or a 1- 
through 32-character string. The order in which you specify the units is 
significant; address lookup procedures determine a match based on the 
order. 

ORGANIZATION _NAME or ON 

Specifies the name of the organization associated with the mailbox. Enter 
the name as a 1- through 64-character string. 

DESCRIPTION or D 

Special attributes: BY _NAME 

Specifies a 1- through 64-character string that describes the mailbox. 


TELEPHONE _NUMBER or TN 
Special attributes: BY _ NAME 


Specifies the telephone number of the mailbox owner. Enter a string of 1 
through 32 characters. 
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RETENTION _PERIOD or RP 
Special attributes: BY_NAME 


Specifies the number of days a letter is retained in the mailbox after it 
has been seen. Enter the keyword MAXIMUM or an integer value from 1 
through 365 for the number of days to retain letters. 


The default is the value set by the MAILVE_RETENTION _LIMIT 
validation. 
PERMIT _TYPE or PT 
Special attributes: BY_NAME 
Specifies the type of mailbox permission. Enter one of the following 
keywords: 

GROUP or G 


A group of defined mailboxes can read mail from or send mail to the 
mailbox. To add or delete mailboxes from the group, use the EMAIL 
ADD_PERMISSION and DELETE_PERMISSION subcommands. 


PRIVATE or PR 
Only the mailbox owner can read mail from the mailbox. Anyone can 
send mail to the mailbox. 
PUBLIC or PU 
Any user can read mail from or send mail to the mailbox. 
The default for new mailboxes is PRIVATE; the default for existing 
mailboxes is that PERMIT_TYPE remains unchanged. 
TITLE or T 
Special attributes: BY_NAME, HIDDEN 


Specifies the message transfer agent name (MTA) assigned to the Mail/VE 
installation where this mailbox is defined. The GENERATE _REMOTE _ 
UPDATES command uses this parameter to denote the residency of 
mailboxes. When using the CREATE DISTRIBUTION _LIST subutility, you 
enter this parameter to show that the mailbox is remote. 


STATUS 
Special attributes: VAR, BY_NAME 


Specifies the completion status for this subcommand. 


Remarks For detailed information on specifying Mail/VE addresses, see chapter 2 of 
the Mail/VE Version 2 Usage manual. 


60464515 C ADMINISTER_MAIL Utility 5-71 


Functions 


Functions 


This section describes the Mail/VE functions. The functions are listed in alphabetical 
order. 


Functions can be used in procedures, for example, to return values for various Mail/VE 
attributes. See the NOS/VE System Usage manual for information on functions and 
procedures. 
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SADMINISTERED _FAMILY 
ADMM Function 


Purpose Returns the current ADMINISTER_MAIL utility default for FAMILY as a 
name. 


Format $ADMINISTERED _ FAMILY 


Remarks $ADMINISTERED _FAMILY does not change if the Mail/VE administrator 
displays a remote mailbox or distribution list. 
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SADMINISTERED _USER 
ADMM Function 


Purpose Returns the current ADMINISTER_MAIL utility default for USER as a 
name. 


Format $ADMINISTERED _USER 


Remarks S$ADMINISTERED_USER does not change if the Mail/VE administrator 
displays a remote mailbox or distribution list. 
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SANY_MAIL 
ADMM Function 


Purpose 


Format 


Parameters 
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Returns a boolean value telling you whether there is mail for the mailbox 
identified by the address that meets the criteria you specify. 


$ANY_MAIL 
(ADDRESS: string or record 
MAIL _OPTIONS: keyword or list of keyword) 


ADDRESS 


Specifies the mailbox to be checked for mail. Only the personal name is 
required. Specify the organization unit(s) and organization name associated 
with the mailbox to further define the address. Enter the address as a 
string or as a record in the format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0. .32 
organization_name: string 0. .64 
recend 


See chapter 2, Mail/VE Addresses, of the Mail/VE Version 2 Usage manual 
if you need more information on specifying mailbox names. 
The default is the value returned by the $IDENTITY function. 


MAIL _OPTIONS 


Specifies the types of letters to be included in the letter list from the 
mailbox checked for mail. You can specify one or more options for each 
option type. 


If you select more than one option for each type, each selection applies. 
Selecting all options for any type has the same effect as selecting none of 
the options for that type. 


Letter types: 


LETTER or L 
Lists all letters. 


RECEIPTS or R 


Displays letters generated upon receipt or nonreceipt of a letter. 
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Read Status types: 


These options apply only to owned mailboxes. 


SEEN or S 


Lists letters that have been displayed using LIST_MAIL or COPY_ 
LETTER _PARTS by the $ADMINISTERED_USER. 


UNSEEN or US 

Lists letters that have not been displayed. 
Sensitivity types: 

PRIVATE or PR 


Lists private letters. 


PERSONAL or PE 


Lists personal letters. 


CONFIDENTIAL or CO 
Lists confidential letters. 


Receipt Certification types: 


CERTIFIED or C 
Lists certified letters. 


UNCERTIFIED or UC . 
Lists letters not classified as certified. 
Importance types: 


LOW_IMPORTANCE or LI 


Lists letters the sender assigned low importance. 


NORMAL_IMPORTANCE or NI 


Lists letters the sender assigned normal importance. 


HIGH _IMPORTANCE or HI 


Lists letters the sender assigned high importance. 
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Delivery Priority types: 
NORMAL_PRIORITY or NP 


Lists letters the sender assigned normal delivery priority. 


URGENT _PRIORITY or UP 
Lists letters the sender assigned urgent delivery priority. 
NON _URGENT_PRIORITY or NUP 


Lists letters the sender assigned nonurgent delivery priority. 
Other types: 


REPLY_REQUEST or RR 


Lists letters for which the sender requested a reply. 


AUTOFORWARDED or A 
Lists letters that have been automatically forwarded from another 
mailbox. 
ALL 
Lists all mail. 
The default is ALL. 


Remarks The $ANY_MAIL function returns TRUE if any mail is found that 
satisfies the criteria specified by the function parameters. 


Examples In the following example, $ANY_MAIL is used to check for mail prior to 
executing LIST_MAIL: 


Admn/if $any_mail(’margaret olson’ unseen) then 
Admm/1ist_mail 
Admm/ i fend 


60464515 C is ADMINISTER_MAIL Utility 5-77 


Functions 


$DEFAULT_MAILBOX 
ADMM Function 


Purpose Returns a record containing the default mailbox for $ADMINISTERED _ 
USER. 


Format $DEFAULT_MAILBOX 


Parameters None. 


Remarks The $DEFAULT_MAILBOX function returns the local address record in the 
format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list of 0..4 of string 0..32 
organization_name: string 0..64 
recend 


Examples This example uses the NOS/VE command DISPLAY_VALUE to display the 
default mailbox data structure: 


Admm/select_user user=jjj .. 
Admn../display_value $default_mailbox .. 
Admn. ./display_opt ion=data_structure 
display_opt ion=DATA_STRUCTURE 


"RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" ’ Jones’ 
GIVEN_NAME: "STRING" ’ John’ 
INITIALS: "STRING" ’J’ 
GENERATION_QUALIFIER: "STRING" ’’ 
"RECORD END" 
ORGANIZATION_UNITS: "LIST" 
1: "STRING" ’CDCNET’ 
"LIST END" 
ORGANIZATION_NAME: "STRING" %’ 
"RECORD END" 
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$DISTRIBUTION _LIST_ATTRIBUTE 
ADMM Function 


Purpose 


Format 


Parameters 
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Returns the value of a specified distribution list attribute. 


$DISTRIBUTION _LIST_ATTRIBUTE 
(ADDRESS: string or record 
OPTION: keyword ) 


ADDRESS 

Specifies a distribution list address. 

S$ADMINISTERED_USER must own the distribution list you specify or an 
empty string will be returned when you use this function. 


Only the distribution list name is required. Specify the organization unit(s) 
and organization name associated with the distribution list to further 
define the address. Enter the address as a string or as a record in the 
format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


OPTION 


Specifies the attribute whose value is to be returned. Enter one of the 
following keywords. 


ADDRESS or A 


Returns the local address record. 


ADDRESS _LIST or AL 


Returns the list of addresses that make up the distribution list. The 
value is returned as a list of global address records. 


ADDRESS _LIST_SIZE or ALS 


Returns an integer specifying the number of entries in the distribution 
list. 


EXPAND or E 


Returns a boolean value that indicates whether the distribution list will 
be expanded in the letter header. 


PERMISSION _LIST or PL 


Returns the permission list entries that define a group distribution list. 
The value is returned as a list of global address records. 
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PERMISSION _LIST_SIZE or PLS 


Returns an integer specifying the number of entries in the permission 
list for a group distribution list. 


PERMIT_TYPE or PT 
Returns a string containing PRIVATE, PUBLIC, or GROUP. 


DESCRIPTION or D 


Returns a string of 1 to 64 characters that describes the distribution 
list. 


TELEPHONE_NUMBER or TN 


Returns a string of up to 32 characters that contains the telephone 
number associated with the distribution list. 
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Distribution list attributes that have not been defined return an empty 


value. 


This function returns address records in the following formats. 


Local address records: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


Global address records: 


record 

personal_name: record 

surname: string 1..40 

given_name: string 0..16 

initials: string 0..5 

generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
private_domain: string 0..16 
administrative_domain: string 0..16 
country: string 0..3 
X121_address: string 0..15 
terminal_identifier: string 0..24 
ua_identifier: string 0..32 
domain_defined_attributes: list 0..4 

record 

name: string 1..8 
value: string 1..128 
recend 
recend 


Permission _records: 


record 
personal_name:record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
private_domain: string 0..16 
administrative_domain: string 0..16 
country: string 0..3 
recend 
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Examples The following example uses the $DISTRIBUTION _LIST_ATTRIBUTE 
function with the NOS/VE DISPLAY_VALUE command to display the 
number of addresses in the list. 


Admm/display_value $distribution_list_attribute .. 
Admm../(’pubs_group’, als) 
15 


The following example displays the distribution list address record using 
the DATA_STRUCTURE option of the DISPLAY_ VALUE command. 


Admm/display_value $distribution_list_attribute .. 
Admm../(’defect_free_team’ address) do=ds 
display option: DATA_STRUCTURE 


"RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" “DEFECT FREE TEAM’ 
GIVEN_NAME: "STRING" ’’” 
INITIALS: "STRING" °7% 
GENERATION_QUALIFIER: "STRING" ”’ 
"RECORD END" 
ORGANIZATION_UNITS: "LIST" 
1: "STRING" “PINK’ 
"LIST END" 
ORGANIZATION_NAME: "STRING" ’” 
"RECORD END" 


= 
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This example uses the DATA_STRUCTURE option of the DISPLAY_ 
VALUE command to display the address list record of the specified 
distribution list. 


Admm/display_value $distribution_list attribute . 
Admm../(’defect_free_team’ address_list) do=ds 
display option: DATA_STRUCTURE 
"LIST" 
1: "RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" ’RODRIGUEZ’ 
GIVEN_NAME: "STRING" ‘’VOLNEY’ 
INITIALS: "STRING" °% 
GENERATION_QUALIFIER: "STRING" 
"RECORD END" 
ORGANIZATION_UNITS: "LIST" 
1: "STRING" “PINK” 
"LIST END" 
ORGANIZATION_NAME: "STRING" ’% 
PRIVATE_DOMAIN: "STRING" ”’ 
ADMINISTRATIVE_DOMAIN: "STRING" ’% 
COUNTRY: "STRING" “°’ 
X121_ADDRESS: "STRING" ’% 
TERMINAL_IDENTIFIER: "STRING" °%7” 
UA_LIDENTIFIER: "STRING" ’’ 
DOMAIN_DEFINED_ATTRIBUTES: “EMPTY LIST" 
“RECORD END" 
2. "RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" “BEDIENT ’” 
GIVEN_NAME: "STRING" -’CONRAD’ 
INITIALS: "STRING" ’K.’ 
GENERATION_QUALIFIER: “STRING” 
"RECORD END® 
ORGANIZATION_UNITS: "LIST" 
1: "STRING" ‘COBALT’ 
"LIST END" 
ORGANIZATION_NAME: "STRING" ”’ 
PRIVATE_DOMAIN: "STRING" °7% 
ADMINISTRATIVE_DOMAIN: "STRING" ~§ 7’? 
COUNTRY: "STRING" ”7” 
X121_ADDRESS: "STRING" 7”7” 
TERMINAL_IDENTIFIER: "STRING" id 
UA_IDENTIFIER: "STRING" ae 
DOMAIN_DEFINED_ATTRIBUTES: “EMPTY LIST" 
“RECORD END" 
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_ $IDENTITY 
» ADMM Function 


Purpose Returns a record that contains the address by which the 
$ADMINISTERED _USER is known to the mail system. 


| Format —- $IDENTITY 
: Parameters None. 
Remarks ® The $IDENTITY function returns a local address record in the format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list of 0..4 of string 0. .32 
organization_name: string 0..64 
recend 


® Within ADMINISTER_MAIL, $IDENTITY always returns the value of 
the default mailbox for the user specified by $ADMINISTERED _USER. 


@ Within ADMINISTER_MAIL, $IDENTITY and $DEFAULT_MAILBOX 
functions return the same information. . 


Examples The following example uses the NOS/VE command DISPLAY_VALUE to 
display $IDENTITY. 


Admm/display_value $identity 
Johnson 
Paul 
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$LETTER 
ADMM Function 


Purpose Returns a string containing the letter identifier of the current letter (that 
is, the most recently displayed letter). 


Format $LETTER 
Parameters None. 


Remarks Use LIST_MAIL to establish a letter list in the mailbox before you use 
_the $LETTER function. If a letter list does not exist, an empty string is 
returned. 


Examples This example uses the NOS/VE command DISPLAY_VALUE to display 
$LETTER: 


Admm/display_value $letter 
JA27 
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$LETTER _ATTRIBUTE 
ADMM Function 


Purpose Returns the value of a selected letter attribute. 


Format $LETTER _ATTRIBUTE 
(OPTION: keyword 
LETTER: keyword or integer or string ) 


Parameters OPTION 


The attribute whose value is to be returned. Enter one of the following 
keywords. 


AUTO _FORWARDED 


Returns the boolean value TRUE if the letter was automatically 
forwarded from another mailbox; otherwise, returns FALSE. 


CERTIFIED 


Returns the boolean value TRUE if the sender requested certified 
delivery; otherwise, returns FALSE. 


DATE _TIME __EXPIRES 


Returns a record containing the date and time that sender specifies as 
the expiration of the letter. 


DATE __TIME __RECEIVED 


Returns a record containing the date and time the letter was received. 


DATE _TIME __SENT 


Returns a record containing the date and time the letter was sent. 


DELIVERY_PRIORITY 

Returns a string that specifies the sender's rating of the urgency of the 
letter as URGENT or NON _URGENT. 

IMPORTANCE 


Returns a string specifying the sender's rating of the the importance of 
the letter as NORMAL, LOW, or HIGH. 


LETTER _PARTS 


Returns a list of one or more strings specifying the type(s) of 
information contained in the message. 


MESSAGE _IDENTIFIER 
Returns the X.400 message identifier in a string of 0 to 64 characters. 


MESSAGE _SIZE 
Returns the size of the message (in bytes) as an integer. 


MESSAGE _TYPE 
Returns a string containing LETTER or RECEIPT. 
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NUMBER _OF_LETTER_ PARTS 

Returns an integer specifying the number of parts in the letter body. 
The number can be zero if the subject is the entire letter body. 
ORIGINATOR 


Returns the sender's address in a global address record. 


REPLY_REQUEST 

Returns the boolean value TRUE if the sender requested a reply; 
otherwise, returns FALSE. 

RETAIN __UNTIL 

Returns the date and time until which the letter is retained in the 
system. 

SEEN 

Returns a boolean value specifying whether the letter has been 
displayed. Applies only to owned mailboxes. 

SENSITIVITY 

Returns a string specifying the sender's rating of the sensitivity of the 
letter as PERSONAL, PRIVATE, or CONFIDENTIAL. 

SUBJECT 

Returns the subject of the letter in a string of up to 128 characters. 


LETTER 


Specifies the letter for which an attribute is returned. Specify the letter by 
letter number (integer), identifier (a string of 1 to 6 characters), or 
keyword. 


The letter number is the number from the previous letter list. It can 
change each time you enter the LIST_MAIL subcommand. 


The letter identifier is permanently assigned to the letter and is not 
related to previous execution of any command. 


Keyword options: 


CURRENT or C 


Displays a value from the current letter in the letter list. (The current 
letter is the letter most recently displayed.) 


FIRST or F 
Displays an attribute value from the first letter in the list. 


LAST or L 
Displays an attribute value from the last letter in the list. 


NEXT or N 


Displays an attribute value from the next letter in the list. 


PREVIOUS or P 
Displays an attribute value from the previous letter in the list. 
The default is CURRENT. 
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Remarks e Ifa letter list does not exist, an empty string is returned. 


@e The $LETTER function returns the value of the current letter from the 
letter list (that is, the letter most recently displayed). 


Examples This example displays the subject of the current letter. 


Admm/create_variable letter subject 
Admm/letter_subject=$letter_attribute (subject) 
Admm/display_value letter_subject 

Reply TO: How about lunch on Monday? 


This example displays the DATE_TIME_EXPIRES for. a letter using the 
DATA _STRUCTURE option of the DISPLAY_VALUE command. 


Admm/display_value $letter_attribute(date_t ime_expires) 
do=ds 
display option: DATA_STRUCTURE 


"DATE_TIME" — 
DAY: "INTEGER" 2088 
MONTH: "INTEGER" 6 
DAY: "INTEGER" 12 
HOUR: "INTEGER" 9 
MINUTE: "INTEGER" 50 
SECOND: "INTEGER" 26 
MILLISECOND: "INTEGER" 907 
"DATE_TIME END" 


This example displays the originator for a letter using the DATA_ 
STRUCTURE option of the DISPLAY_VALUE command. 


Admm/display_value $letter_attribute(originator) do=ds 
display option: DATA_STRUCTURE 


"RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" “’Albrecht’ 
GIVEN_NAME: "STRING" “’Bruce’ 
INITIALS: "STRING" ’G’ 
GENERATION_QUALIFIER: "STRING" “’ 
"RECORD END" 
ORGANIZATION_UNITS: "LIST" 
1: "STRING" ‘’CDCNET’ 
"LIST END" 
ORGANIZATION_NAME: "STRING" 5 
PRIVATE_DOMAIN: "STRING" ’” 
ADMINISTRATIVE_DOMAIN: "STRING" “’ATTMAIL’ 
COUNTRY: "STRING" ’US’ 
X121_ADDRESS: "STRING" “°’ 
TERMINAL_IDENTIFIER: "STRING" ’’ 
UNIQUE_UA_IDENTIFIER: "STRING" ’’ 
DOMAIN_DEFINED_ATTRIBUTES: "EMPTY LIST" 
"RECORD END" 
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$LETTER _LIST 

ADMM Function 

Purpose Returns the ietter list as a list of strings containing letter identifiers. 
Format $LETTER _LIST 


Parameters None. 


Remarks Use LIST_MAIL to establish a letter list in the mailbox before using the 
$LETTER __LIST function. If a letter list does not exist, an empty list is 
returned. 


Examples The following example is a procedure that searches a letter list for letters 
received on or before a specified month and deletes those letters. 


Admm/date_to_f ind=$now 

Admm/if date_to_find.month > 1 then 
if/date_to_find.month = date_to_find.month -1 
if/else 

if/date_to_find.month = 12 

if/ifend 

Admm/list_mail ‘newswire’ output = $null 
Admm/for each Itr in $letter_list do 
for/date = $letter_attribute( 
for../date_time_received Itr) 

for/if date.month = date_to_find.month then 
if/read_letter Itr o=new_letters.$eoi 
if/ifend 

for/forend 

Admm/ 
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$S$MAILBOX 
ADMM Function 


Purpose Returns a local address record containing the address of the mailbox 
selected for read operations. 


Format $MAILBOX 
Parameters None. 


Remarks © Use LIST_MAIL to establish a letter list before using the $MAILBOX 
function. $MAILBOX returns the local address of the mailbox for which 
a letter list is created. If a letter list does not exist, $MAILBOX 
returns an empty value. 


@e The format of the local address record: 


record 
personal_name: record 
surname: string 1..40 
Qgiven_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


Examples The following example displays the name associated with the mailbox 
selected for read operations. 


Admm/selu pij 

Admm/1lism o=$nul1 
Admm/display_value $mai1box 
Johnson 

Paul 
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S$MAILBOX _ATTRIBUTE 
ADMM Function 


Purpose 


Format 


Parameters 


60464515 C 


Returns the value of a specified mailbox attribute for a mailbox identified 
by its address. 


$MAILBOX __ATTRIBUTE 
(ADDRESS: record or string 
OPTION: keyword ) 


ADDRESS 


Specifies the address of the mailbox for which an attribute value is to be 
returned. Only the personal name is required. Specify organization unit(s) 
and organization name to further define the address. 


The mailbox must be owned by the $ADMINISTERED_USER or an empty 
string is returned. 


Enter the address as a 1- to 64-character string or as a record in the 
format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0. .32 
organization_name: string 0..64 
recend 


ADMINISTER_MAIL Utility 5-91 


Functions 


OPTION 


Specifies the name of the attribute value to be returned. Enter one of the 
following keywords: 


ADDRESS or A 


Returns the mailbox address. If the mailbox is not owned by the 
$ADMINISTERED _USER, an empty string is returned. The address is 
returned as a list of local address records in the following format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list of 0..4 of string 0. .32 
organization_name: string 0..64 
recend 


PERMISSION _LIST or PL 


Returns the permission list entries. The value is Poulenc? as a list of 
access permission records. 


PERMISSION _LIST_SIZE or PLS 


Returns an integer specifying the nue of entries in the permission 
list. . 


PERMIT_TYPE or PT 
Returns a string containing PRIVATE, PUBLIC, or GROUP. 


DESCRIPTION or D 


Returns a string of 1 to 64 characters that describes the mailbox. 


RETENTION _PERIOD or RP 


Returns an integer (from 1 to 365) specifying how long a letter that 
has been displayed remains in the mailbox to which it was sent before 
being deleted from the system. 


TELEPHONE __NUMBER of TN 


Returns the phone number associated with the mailbox in a string of 
up to 32 characters. 
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@ Mailbox attributes that have not been defined return an empty string. 


@ This function returns address records in the following formats. 


Local address records: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


Global address records: 


record 

personal_name: record 

surname: string 1..40 

given_name: string 0..16 

initials: string 0..5 

generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
private_domain: string 0..16 
administrative_domain: string 0..16 
country: string 0..3 
x121_address: string 0..15 
terminal_identifier: string 0..24 
ua_identifier: string 0..32 
domain_defined_attributes: list 0..4 

record 

name: string 1..8 
value: string 1..128 
recend 
recend 


The following example displays the permission _list for a mailbox using the 


DATA __STRUCTURE option of the DISPLAY_VALUE command. 


Admn/display_value $mailbox_attribute(permission_list) 
do=ds 
display option: DATA_STRUCTURE 


"LIST" 
1: "RECORD" 
PERSONAL_NAME: "RECORD" 
SURNAME: "STRING" *HOWARD’ 
GIVEN_NAME: "STRING" “FRANK’ 
INITIALS: "STRING" ’’ 
GENERATION_QUALIFIER: "STRING" 
"RECORD END" 
ORGANIZATION_UNITS: "LIST" 
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S$MAILVE _INSTALLATION 
ADMM Function 


Purpose Returns the values assigned to Mail/VE during installation as a string. 


Format $MAILVE _INSTALLATION 
(NAME: keyword) 


Parameters NAME 


Specifies the Mail/VE installation information to retrieve. Enter one the 
following keywords: 


ADMINISTRATIVE _DOMAIN or AD 


Returns the name of the administrative domain assigned to this 
Mail/VE installation. 


COUNTRY or C 


Returns the country code assigned to this Mail/VE installation. See 
appendix C for the list of countries and their associated codes. 


DATABASE __CATALOG or DC > 


Returns the database catalog path name assigned to this Mail/VE 
installation. . 


MESSAGE __TRANSFER_AGENT or MTA 


Returns the message transfer agent (MTA) name assigned to this 
Mail/VE installation. . 


PRIVATE __DOMAIN or PD 


Returns the name of the private domain assigned to this Mail/VE 
installation. 


STATUS 
Special attributes: VAR, BY_NAME 
Specifies the completion status for this subcommand. 


Remarks If no value was assigned during installation, the system returns an empty 
string. 
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SMAILVE _USERS 
ADMM Function 


Purpose Returns a list of NOS/VE users within a family that have been registered 
with Mail/VE. 


Format $MAILVE _USERS 
FAMILY: name 


Parameters FAMILY 


Specifies the family for which a list of users is to be returned. 
The default is $ADMINISTERED _FAMILY. 


Examples The following example displays the Mail/VE users list using the DATA_ 
STRUCTURE option of the DISPLAY_VALUE command. 


Admm/display_value $mailve_users do=ds 
display option: DATA_STRUCTURE 


"LIST" 
1: "RECORD" 
FAMILY: “NAME" PINK 
USER: "NAME" AAS 
"RECORD END" 
2: "RECORD" 
FAMILY: "NAME" PINK 
USER: "NAME" ABELSET 
“RECORD END" 
3: "RECORD" 
FAMILY: "NAME" PINK 
USER: "NAME" ACSDTIM 
"RECORD END" 


386: "RECORD" 
FAMILY: "NAME" PINK 
USER: "NAME" YCJ 
“RECORD END" 
"LIST END" 
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SOWNED _DISTRIBUTION _LISTS 
ADMM Function 


Purpose Returns a list of records containing the addresses of the distribution lists 
owned by $ADMINISTERED _USER. 


Format SOWNED _DISTRIBUTION _LISTS 
Parameters None. 
Remarks @ The local address record is returned in the following format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
rcend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


e If $ADMINISTERED _USER does not own any distribution lists, an 
empty list is returned. 


Examples The following example is a procedure that lists the length of owned 
distribution lists. a 


Admm/for each dl in $owned_distribution_list 
for/display_value d1l.distribut ion_list_name// 
for../’ contains ’// . 

for. ./$strrep( 

for. ./$distribution_list_attribute . 

for../ (dl,address_list_size)// .. 

for../’ addresses’ 

for/forend 

DTEAM contains 6 addresses 

DEPT_LIST contains 9 addresses 

Admm/ 


5-96 Mail/VE Version 2 Administration 60464515 C 


Functions 


SOWNED _MAILBOXES 
ADMM Function 


Purpose Returns a list of records containing the local address of all of the 
mailboxes owned by $ADMINISTERED_USER. 


Format SOWNED _MAILBOXES 
Parameters None. 
Remarks @ The local address record is returned in the following format: 


record 
personal_name: record 
surname: string 1..40 
given_name: string 0..16 
initials: string 0..5 
generation_qualifier: string 0..3 
recend 
organization_units: list 0..4 of string 0..32 
organization_name: string 0..64 
recend 


e@ If $ADMINISTERED_USER has no mailboxes, an empty list is 
returned. 


Examples The following example is a procedure that checks all owned mailboxes for 
mail. 


Admm/mailbox_list = $owned_mai]boxes 
Admm/for each box in mailbox_list do 
for/read_mail personal_name = .. 
for../box.personal_name mail_options = all 
for/forend 

Admm/ 
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A 


Address 

Defines the location of a mailbox or distribution list in a mail system. An address is 
composed of attributes that define a unique entry in the mail directory. 
Administrative Domain 


_ Under X.400 mail system standards, an administrative domain manages electronic mail 
services. In countries that have a national telephone service, such as the United 
Kingdom, that service would be likely to act as the administrative domain. In countries 
that have a competitive telephone industry, such as the United States, there can be 
several administrative domains. 

Attributes 


Characteristics assigned to a mailbox or distribution list by the user or Mail/VE 
administrator. Characteristics include name, associated organization units, associated 
organization name, description, owner's telephone number, and type of access permitted. 


B 
BITNet 


An economical, low speed network (meaning Because It's Time Network). It consists of 
mainframe computers (primarily IBM) interconnected by 9600-bps leased lines. The 
network, developed by City University in New York, connects universities across the 
country and attaches to the European network, EARN. 


C 
CCITT 


Consultative Committee on International Telephony and Telegraphy. This international 
organization establishes standards for interconnection of telephone equipment. 
Country Code 


Alpha or numeric code representing a country in X.400 addresses. The ISO Standard 
3166 provides the alpha codes for participating countries, and the CCITT 
Recommendation gives the numeric codes for these countries. 


D 


Default Mailbox 


Identity mailbox under which a user begins a mail session. The first mailbox created 
by or for a user is that user's default mailbox. Users can change the default mailbox 
to any mailbox they own anytime during a mail session. 


Directory 


List of all mailbox and distribution list addresses registered with a mail system. 
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Distribution List 

Named recipient list that is addressable. A distribution list can contain both mailbox 
and other distribution list addresses. It cannot contain its own address. 

Domain 


Within each country in a worldwide electronic mail network, designated authorities 
manage the electronic mail systems. Under X.400 mail system standards, these 
authorities are called domains. 


There are administrative and private domains: 
@ Administrative domains are usually the telephone services in a country. 


@ Private domains can be corporations or any other group that wants to manage a 
private domain of mail users. A private domain can be associated with more than 
one administrative domain. Also, a private domain need not be registered with any 
administrative domain. By mutual agreement, private domains can choose to be 
directly connected with one another. 

Domain Name File 


A translation table that enables Mail/VE users to enter BITNet and Internet addresses. 
It includes BITNet address information from BITNIC (BITNet Information Center) and 
local entries that associate X.400 addresses with Internet addresses. 

Domain-Wide Directory 


A directory that contains some or all of the local and remote addresses in a private 
domain. 


E 
EARN 


European Academic Research Network. This network, which connects European 
universities and research laboratories, attaches to the American network, BITNet. 


G 


Global Address 


Address that contains attributes that allow users on different mail systems anywhere in 
the world to communicate. 


The global address attributes specify the Administrative Domain, Private Domain, and 
Country where the mail system resides. Addresses identify mailboxes or distribution 
lists. 


Global Key 


An identifier for a mailbox or distribution list that is unique within a private domain. 
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I 


Identity 

The first mailbox created by or for a user is that user's initial identity. The identity 
mailbox is used: 

e As the From address for sending letters. 

@ To determine which mailboxes the user can read from, which mailboxes can be 

_ delivered mail, and which distribution lists can be used. 


Users can change their identity any number of times during the mail session. 


Internet 
A collection of networks and gateways that use the TCP/IP protocols and act as a 
single network. The collection includes: 


@ ARPANET, an early network developed by the Advanced Research Projects Agency 
(now called the Defense Advanced Research Projects Agency) 


@ MILNET, (MILitary NETwork) the network used by military installations, 
institutions doing military research, and national laboratories. 


@ NSFnet (National Science Foundation NETwork), the network and associated 
(midlevel and supercomputer) networks that were originally funded by the National 
Science Foundation 


L 


Letter 


Message generated by a mail system user. The letter contains a header and a body. 
The address on the letter directs the letter through the mail system. 


The letter header contains origination and delivery information and the subject of the 
letter. 


The letter body is the content of the letter. The letter body can include ASCII text or 
nontext characters, such as binary code and/or graphics. 


Local Address 


Associates a mailbox or distribution list with a particular mail system. The local 
address attributes are the personal name of the mailbox or distribution list, and the 
organization name and organization unit(s) associated with the address. 


M 

Mail 

See Message. 
Mailbox 


Used to send and receive mail. Mailboxes can be private, group, or public. 


Mail/VE Administrator 


The systems administrator responsible for installing, configuring, and maintaining 
Mail/VE. 
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Mail/VE Gateway 


The software that supports the exchange of mail between Mail/VE and mail systems on 
Internet (using SMTP) and BITNet/EARN (using NJE) networks. It specifies the 
mapping between X.400-430 (CCITT Draft Recommendations on Message Handling 
Systems) and RFC822 (Standard for the Format of Internet Text Messages) protocols. 


The gateway performs the following tasks: 


@ Converts messages between the X.400 protocol and those used in the BITNet and 
Internet networks. 


e@ Routes mail between these networks. 


MTA 
See Message Transfer Agent. 


Message 


A letter, notice, or receipt. 


Message Transfer Agent (MTA) 


Software that transfers messages to and from user agents on a mail system. 


N 


Network Job Entry (NJE) 
An IBM protocol used as the communication link between BITNet nodes. 


Network Transfer Facility (NTF) 
A NOS/VE application that supports the IBM Network Job Entry protocol. 


NJE 
See Network Job Entry. 


Notice 


Message generated by the mail system specifying whether or not a letter has been 
delivered to the address. The letter sender must request a delivery notice when 
composing a letter. Nondelivery notices are generated unless the sender specifies 
otherwise. 


NTF 
See Network Transfer Facility. 


O 


Organization 


Any group defined on a CREATE_ORGANIZATION subcommand by a Mail/VE 
administrator. The administrator can define an organization as one of the following: 


@ An organization name 
e An ordered set of organization units 


@ An organization name and an ordered set of organization units 
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Organization Name 


Under X.400 addressing standards, the name of a particular organization or company 
within a domain. See also Domain. 


Organization Units 


Under X.400 addressing standards, the organization units specify the internal structure 
of an organization within a domain. See also Organization Name and Domain. A 
maximum of four organization units can be specifed for an address; for example, task 
group, project, department, division. 

Owner 


Mail/VE user who creates a mailbox or distribution list. Only the owner and Mail/VE 
administrator can delete or alter a mailbox or distribution list even though others may 
be permitted to use them. 


P 


Personal Name 

Under X.400 addressing standards, the name of a mailbox or distribution list. Mailbox 
and distribution list names are the primary identification of an address in Mail/VE. 
Private Domain 


Under X.400 mail system standards, a corporation or any other group that manages a 
private domain of mail users. A private domain can be associated with more than one 
administrative domain. Also, a private domain need not be registered with any 
administrative domain. By mutual agreement, private domains can choose to be directly 
connected with one another. 


R 


Request for Comments (RFC) 

Name of a series of notes available across the Internet. The notes cover many 
communication topics including Internet protocol standards. 

RFC 


See Request for Comments. 


Receipt 

Message generated by the mail system to indicate whether or not the user displays a 
letter. The letter sender must request a receipt when composing a letter. 

Recipient 

Mailbox or distribution list address to which a letter is sent. 


Retention Period 


Integer between 1 and 365 specifying the number of days letters sent to a mailbox are 
kept before the system deletes them. Users can specify the retention period when they 
create or change the mailbox definition. 
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S 


Simple Mail Transport Protocol (SMTP) 


A mail transfer protocol described in RFC821 Simple Mail Transport Protocol. SMTP 
sends and receives mail in the Internet community. 


SMTP 
See Simple Mail Transport Protocol. 


T 
TCP/IP 


See Transmission Control] Protocol/Internet Protocol. 


Title 


Name of the message transfer agent. 


Transmission Control Protocol/Internet Protocol (TCP/IP) 


A suite of protocols that support the Internet community. 


U 


UA 
See User Agent. 


User Agent (UA) 
Address identifier from which X.400 messages are sent and received. 


W 


Wildcard Character 


Character used in lookup procedures to represent omitted parts of an address. The 
asterisk (*) is recognized as the wildcard character in Mail/VE. It matches from 0 to 
256 other characters. 


For example, entering 


Tookup_address ’* Hanson’ 
. address opt ions=(mailbox) 


lists all mailbox addresses with HANSON as the surname component of the mailbox 
name. 


Xx 


X.400 Mail System 


An electronic mail system that conforms to the internationally accepted standards 
described in the X.400-430 CCITT Draft Recommendations on Message Handling 
Systems. For example, Mail/VE is an X.400 mail system. 
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Related Manuals B 


All NOS/VE manuals and related hardware manuals are listed in table B-1. If your 
site has installed the online manuals, you can find an abstract for each NOS/VE 
manual in the online System Information manual. To access this manual, enter: 


/help manual=nos_ve 


Ordering Printed Manuals 
To order a printed Control Data manual, send an order form to: 


Control Data 

Literature and Distribution Services _ 
308 North Dale Street 

St. Paul, Minnesota 55103-2495 


To obtain an order form or to get more information about ordering Control Data 
manuals, write to the above address or call (612) 292-2101. If you are a Control Data 
employee, call (612) 292-2100. 

Accessing Online Manuals 


To access the online version of a printed manual, log in to NOS/VE and enter the 
online title on the HELP command (table B-1 supplies the online titles). For example, 
to see the NOS/VE Commands and Functions manual, enter: 


/ivelp manual=scl 
or, because SCL is the default for the MANUAL parameter, simply enter 
/nelp 


An online Examples manual contains examples that reside in printed manuals. From 
within the online Examples manual, you can copy, print, and execute the examples it 
contains. To access this manual, enter: 


/help manual=examples 


When EXAMPLES is listed in the Online Manuals column in table B-1, that manual is 
represented in the online Examples manual. 
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Related Manuals 


Table B-l. Related Manuals 


. Publication Online 
Manual Title Number Manuals! 


NOS/VE Site Manuals: 


CYBER 930 Computer System 60469560 
Guide to Operations 

Usage 

CYBER Initialization Package (CIP) 60000417 


CYBER 180 Model 810, 830, 815, 825; 
CYBER 810A, 830A Computer 
Systems Reference Manual 


CYBER Initialization Package (CIP) 60000418 
CYBER 180 Model 835, 845, 855; 

CYBER 840, 850, 860 Computer 

Systems with IOU AB115A 

Reference Manual 


CYBER Initialization Package (CIP) 60000419 
CYBER 180 Model 845, 855; 

CYBER 840, 850, 860 with IOU 

AT478/AT481A; CYBER 840A, 850A, 

860A, 870A, 990, 990E, 995E 

Computer Systems Reference Manual 


CYBER Initialization Package (CIP) 60000420 
CYBER 960, 994 Computer Systems 
Reference Manual 


CYBER Initialization Package (CIP) 60000421 
CYBER 962, 992 Computer Systems 
Reference Manual 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


NOS/VE Site Manuals (Continued): 


CYBER Initialization Package (CIP) 60000422 
CYBER 170 Model 865, 875; 

Non-Model 8X X/9XX Series 

Computer Systems Reference Manual 


Desktop/VE Host Utilities 60463918 
Usage 


Mail/VE Version 2 60464515 MAILVE _ 
Administration ADMINISTRA- 
TION 


MAINTAIN _MAIL (Version 1)? . MAIM 
Usage 


NOS/VE Accounting Analysis System 60463923 
Usage 


NOS/VE Accounting and Validation Utilities for Dual 60458910 
State 
Usage 


NOS/VE File Server 60000190 
for STORNET and ESM-II 
Usage 


NOS/VE 60463917 . 
LCN Configuration and Network Management 
Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


2. To access this manual, you must be the administrator for Mail/VE Version 1. 
(Continued) 
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Related Manuals 


Table B-l1. Related Manuals (Continued) 


. : Publication Online 
Manual Title Number Manuals! 


Site Manuals (Continued): 


NOS/VE Network Management 60463916 
Usage 

NOS/VE Operations 60463914 
Usage ; 

NOS/VE 60463915 


System Performance and Maintenance 
Volume 1: Performance 
Usage 


NOS/VE 60463925 
System Performance and Maintenance 
Volume 2: Maintenance 


Usage 

NOS/VE Security Administration 60463945 
Usage ; 
NOS/VE User Validation 60464513 
Usage 


NOS/VE User Manuals: 


EDIT_CATALOG EDIT_ 
Usage CATALOG 
EDIT_CATALOG for NOS/VE 60487719 

Summary 

Introduction to NOS/VE 60464012 EXAMPLES 
Tutorial 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-1. Related Manuals (Continued) 


Manual Title 
NOS/VE User Manuals (Continued): 


NOS/VE 
Advanced File Management 
Tutorial 


NOS/VE 
Advanced File Management 
Usage 


NOS/VE 
Commands and Functions 
Quick Reference 


NOS/VE File Editor 
Tutorial/Usage 


NOS/VE 
Object Code Management 
Usage 


NOS/VE Screen Formatting 
Usage 


NOS/VE 
Source Code Management 
Usage 


NOS/VE System Usage 


NOS/VE Terminal Definition 
Usage 


Publication 
Number 


60486412 


60486413 


60464018 


60464015 


60464413 


60488813 


60464313 


60464014 . 


60464016 


Related Manuals 


Online 
Manuals! 


AFM_T 
AFM 
SCL 


EXAMPLES 


OCM and 
EXAMPLES 


EXAMPLES 


SCM and 
EXAMPLES 


EXAMPLES 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1l. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


NOS/VE User Manuals (Continued): 


Screen Design Facility/Screen Formatting 60488613 SDF 
Usage 

Screen Design Facility/Data Management 60488618 

Usage 


CYBIL Manuals: 


CYBIL for NOS/VE 60464114 EXAMPLES 
File Management 
Usage 


CYBIL for NOS/VE 60464117 EXAMPLES 
Keyed-File and Sort/Merge Interfaces 3 
Usage 


CYBIL for NOS/VE 60464113 CYBIL and 
Language Definition - EXAMPLES 
Usage 


CYBIL for NOS/VE 60464116 EXAMPLES 
Sequential and Byte-Addressable Files 
Usage 


CYBIL for NOS/VE 60464115 EXAMPLES 
System Interface 
Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-l. Related Manuals (Continued) 


Manual Title 
FORTRAN Manuals: 


FORTRAN Version 1 for NOS/VE 
Language Definition 
Usage 


FORTRAN Version 1 for NOS/VE 
Quick Reference 


FORTRAN Version 2 for NOS/VE 
Language Definition 
Usage 


FORTRAN Version 2 for NOS/VE 
Quick Reference 


FORTRAN for NOS/VE 
Tutorial 


FORTRAN for NOS/VE 
Topics for FORTRAN Programmers 
Usage 


FORTRAN for NOS/VE 


Summary 


FORTRAN Keyed-File 
and Sort/Merge Interfaces 
Usage 


COBOL Manuals: 


COBOL for NOS/VE 
Summary 


Publication 
Number 


60485913 


60487113 


60485912 


60485916 


60485919 


60485917 


60486019 


Related Manuals 


Online 
Manuals! 


FORTRAN | 


VFORTRAN 


FORTRAN _T 


FORTRAN 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


COBOL Manuals (Continued): 


COBOL for NOS/VE 60486012 COBOL _T 
Tutorial 

COBOL for NOS/VE 60486013 COBOL and 
Usage EXAMPLES 


Other Compiler Manuals: 


Ada for NOS/VE 60498113 ADA 
Usage 

Ada for NOS/VE 60498118 EXAMPLES 
Reference Manual 

APL for NOS/VE 60485814 

File Utilities 

Usage 

APL for NOS/VE — 60485813 

Language Definition 

Usage 

BASIC for NOS/VE 60486319 

Summary Card 

BASIC for NOS/VE 60486313 BASIC 
-Usage 

LISP for NOS/VE 60486213 


Usage Supplement 


Pascal for NOS/VE 60485619 
Summary Card 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-1. Related Manuals (Continued) 


Manual Title 
Other Compiler Manuals (Continued): 


Pascal for NOS/VE 
Usage 


Prolog for NOS/VE 
Usage 


VX/VE Manuals: 


C/VE for NOS/VE 
Quick Reference 


C/VE for NOS/VE 
Usage 


DWB/VX 
Introduction and User Reference 
Tutorial/Usage 


DWB/VX 
Macro Packages Guide 
Usage 


DWB/VX 
Preprocessors Guide 
Usage 


DWB/VX 
Text Formatters Guide 
Usage 


Publication 
Number 


60485618 


60486713 


60469830 


60469890 
60469910 
60469920 


60469900. 


Related Manuals 


Online 
Manuals! 


PASCAL and 
EXAMPLES 


PROLOG 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


VX/VE Manuals (Continued): 


VX/VE 60469770 
Administrator Guide and Reference 
Tutorial/Usage 


VX/VE : 60469980 
An Introduction for UNIX Users 
Tutorial/Usage 


VX/VE 60469790 
Programmer Guide 
Tutorial 


VX/VE 60469820 
Programmer Reference 
Usage 


VX/VE 60469800 
Support Tools Guide 
Tutorial 


VX/VE 60469780 
User Guide 
Tutorial 


VX/VE 60469810 
User Reference 
Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Data Management Manuals: 


DM Command Procedures 60487905 
Reference Manual 

DM Concepts and Facilities 60487900 
Manual 

DM Error Message Summary 60487906 


for DM on CDC NOS/VE 


DM Fundamental Query and 60487903 
Manipulation Manual 


DM Report Writer 60487904 
Reference Manual 


DM System Administrator's 60487902 
Reference Manual 
for DM on CDC NOS/VE 


DM Utilities 60487901 
Reference Manual 
for DM on CDC NOS/VE 


IM/DM for NOS/VE 60487907 
Installation and User Guide 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 


60464515 C Related Manuals B-11 


Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Information Management Manuals: 


IM/Control for NOS/VE L60488918 CONTROL 
Quick Reference 

IM/Control for NOS/VE 60488913 

Usage 

IM/Fast for NOS/VE 60487513 


Administration Usage 


IM/Fast for NOS/VE 60487514 
Programming Usage 


IM/Quick for NOS/VE 60485712 
Tutorial 


IM/Quick for NOS/VE 60485714 
Summary 


IM/Quick for NOS/VE _ QUICK 
Online Help 


IM/Smart for NOS/VE 60488513 
Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) | 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


CDCNET Manuals: 


CDCNET Access Guide CDCNET_ 
ACCESS 

CDCNET Batch Device 60463863 CDCNET_ 

User Guide BATCH 

CDCNET Commands Reference 60000414 

CDCNET Conceptual Overview 60461540 

CDCNET Configuration Guide 60461550 | 

CDCNET DI Dump Analyzer ANACD 

CDCNET Diagnostic Messages 60461600 CDCNET_ 
MSGS — 

CDCNET Network Configuration Utility NETCU 

CDCNET Network Operations 60461520 | 

and Analysis 

CDCNET Product Descriptions 60460590 

CDCNET Terminal Interface 60463850 

CDCNET TCP/IP Applications 60000214 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Migration Manuals: 


Migration from IBM to NOS/VE 60489507 
Tutorial/Usage 

Migration from NOS to NOS/VE 60489503 
Tutorial/Usage 

Migration from NOS/BE to NOS/VE 60489505 
Tutorial/Usage 

Migration from NOS/BE to 60489506 
NOS/VE Standalone 

Tutorial/Usage 

Migration from VAX/VMS to NOS/VE 60489508 
Tutorial/Usage _ 


Miscellaneous Manuals: 


ANALYZE_DUMP Utility ANALYZE _ 
| DUMP 
Applications Directory 60455370 


Control Data CONNECT 60462560 
User's Guide 


Control Data CONNECT Plus for the 60000388 
_IBM Personal Computer (Version 1.0) 
User's Guide . 


Control Data CONNECT VIEW for 60463946 
the IBM Personal Computer _ 

Version 2.0 

User's Guide 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Table B-1. Related Manuals (Continued) 


Manual Title 


Miscellaneous Manuals (Continued): 


Debug for NOS/VE 
Quick Reference 


Debug for NOS/VE 
Usage 


Desktop/VE for Macintosh 
Usage 


FTAM/VE 
Usage 


Mail/VE (Version 1) 
Summary Card 


Mail/VE (Version 1) 
Usage 


Mail/VE Version 2 
Usage 


Math Library for NOS/VE 
Usage 


NOS/VE Build Utility 
Usage 


NOS/VE Diagnostic Messages 
Usage 


NOS/VE Examples 
Usage 


Related Manuals 


Publication Online 


Number 


60488218 
60488213 
60464503 
60000455 


60464519 


60464514 © 


60486513 


60487413 


60464613 


Manuals! 


DEBUG 


MAIL_VE 


MAILVE _V2 


MESSAGES 


EXAMPLES 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 
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Related Manuals 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Miscellaneous Manuals (Continued): 


NOS/VE Global Index 60464010 

Reference 

NOS/VE Online Manual Systems 60488403 TOPICS _ 
CONTEXT 

NOS/VE System Information NOS_VE 

Programming Environment . ENVIRON- 

for NOS/VE MENT 

Usage 

Programming Environment 60486819 

for NOS/VE 

Summary 

Professional Programming 60486618 PPE 


Environment for NOS/VE 
Quick Reference 


Professional Programming 60486613 
Environment for NOS/VE 

Usage 

Remote Host Facility 60460620 
Usage 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


(Continued) 
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Mail/VE Gateway References 


Table B-1. Related Manuals (Continued) 


Publication Online 
Manual Title Number Manuals! 


Hardware Manuals: 


CYBER 170 Computer Systems 60459960 
Models 825, 835, and 855 

General Description 

Hardware Reference 


HPA/VE Reference | 60461930 


Virtual State Volume II 60458890 
Hardware Reference 


1. This column lists the title of the online version of the manual and indicates whether 
the examples in the printed manual are in the online Examples manual. 


Mail/VE Gateway References 


The manuals listed in table B-2 are referenced in chapter 3 and are not listed in 
table B-1. 


Table B-2. Mail/VE Gateway References 


Publication Online 
Manual Title Number Manuals 
Network Transfer Facility 15190150 
Usage Manual 
NOS Version 2 Reference Set, Volume 3 60459680 


System Commands 
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Country Codes C 


60464515 C 


Country Codes C 


Mail/VE allows you to specify the country codes used in X.400 addresses in either 
alpha or numeric code. The ISO Standard 3166 defines the alpha code for each country; 
the CCITT Recommendation X.121 defines the numeric code for each country. Table 
C-1 presents the countries, in alphabetic order, with associated alpha and numeric 
codes. 


Table C-1. Country Codes 


Country Alpha Code Numeric Code 
AFGHANISTAN (Democratic Republic of) AF 412 
ALBANIA (Socialist People's Republic) AL 276 
ALGERIA (Algerian Democratic and Popular DZ 603 
Republic) | 
AMERICAN SAMOA AS 544 
ANDORRA AD 
ANGOLA (People's Republic of) AO 631 
ANGUILLA Al 356 
ANTARCTICA AQ 
ANTIGUA AND BARBUDA AG 344 
ARGENTINE REPUBLIC AR 722 
ARUBA AW 
AUSTRALIA AU 505 
AUSTRIA AT 232 
BAHAMAS (Commonwealth of the) BS 364 
BAHRAIN (State of) BH 426 
BANGLADESH (People's Republic of) BD 470 
BARBADOS BB 342 
BELGIUM BE 206 
BELIZE . BZ 702 
BENIN (People's Republic of) BJ 616 
BERMUDA BM 350 
BHUTAN BT 

| (Continued) 
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Country Codes 


Table C-1. Country Codes (Continued) 


Country 
BOLIVIA (Republic of) 


BOTSWANA (Repubic of) 

BOUVET ISLAND 

BRAZIL (Federative Republic of) 
BRITISH INDIAN OCEAN TERRITORY 
BRUNEI DARUSSALAM 

BULGARIA (People's Republic of) 
BURKINA FASO 

‘BURMA (Socialist Republic of the Union of) 
BURUNDI (Republic of | 
BYELORUSSIAN SSR 

CAMEROON (Republic of) 

CANADA 

CAPE VERDE (Republic of) : 

CAYMAN ISLANDS 

CENTRAL AFRICAN REPUBLIC 

CHAD (Republic of) 

CHILE 

CHINA (People's Republic of) 
CHRISTMAS ISLAND 

COCOS (KEELING) ISLANDS 
COLOMBIA (Republic of) 

COMOROS (Federal and aha Republic of the) 
CONGO @eoplats Republic of | the) | 
COOK ISLANDS 

COSTA RICA 

COTE D'IVOIRE (See Ivory Coast) 
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Alpha Code 
BO 


BW 
BV 
BR 
IO 
BN 
BG 
BF 
BU 
BI 
BY 
CM 
CA 
CV 
KY 


CF 


TD 

CL 

CN 

CX 

CC 

CO 

KM 
CG 

CK 
CR 

CI 


Numeric Code 


736 
652 


724 


528 
284 
613 
414 
642 
250 
624 
302 
625 
346 
623 
622 
730 
460 


732 
654 
629 
548 
712 


612 


(Continued) 
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Table C-1. Country Codes (Continued) 


Country Alpha Code Numeric Code 


CUBA CU | 368 
CYPRUS (Republic of) CY 280 
CZECHOSLOVAK SOCIALIST REPUBLIC CS 230 
DENMARK DK 238 
DJIBOUTI (Republic of) | DJ 638. 
DOMINICA DM 366 
DOMINICAN REPUBLIC e DO — 370 
EAST TIMOR | TP 

ECUADOR | EC 740 
EGYPT (Arab Republic of) . EG 602 
EL SALVADOR (Republic of) — SV 706 
EQUATORIAL GUINEA (Republic of) GQ 627 
ETHIOPIA ET 636 
FALKLAND ISLANDS (MALVINAS) FK 

FAROE ISLANDS FO 288 
FIJI FJ 642 
FINLAND FI 244 
FRANCE FR 208 
FRENCH ANTILLES 340 
FRENCH POLYNESIA PF 547 | 
FRENCH SOUTHERN TERRITORIES TF 

GABON REPUBLIC | GA 628 
GAMBIA (Republic of the) GM 607 
GERMAN DEMOCRATIC REPUBLIC (East) DD 218 
GERMAN FEDERAL REPUBLIC (West) DE 262 
GHANA GH 620 
GIBRALTAR GI 266 

(Continued) 
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Country Codes 


Table C-1. Country Codes (Continued) 


Country 
GILBERT AND ELLICE ISLANDS 


GREECE 

GREENLAND 

GRENADA. 

GUADELOUPE 

GUAM 

GUATEMALA (Republic of) 
GUIANA (French Department of) 
GUINEA (Republic of) 
GUINEA-BISSAU (Republic of) 
GUYANA 

HAITI (Republic of) 

HEARD AND MCDONALD ISLES 
HONDURAS (Republic of) 
HONG KONG 

HUNGARIAN PEOPLE'S REPUBLIC 
ICELAND 

INDIA (Republic of) 
INDONESIA (Republic of) _ 
IRAN (Islamic Republic of) 
IRAQ (Republic of) 

IRELAND 

ISRAEL (State of) 

ITALY 

IVORY COAST (Republic of the) 
JAMAICA 

JAPAN 
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Alpha Code Numeric Code 


545 
GR 202 
GL 290 
GD 352 
GP 
GU 535 
GT 704 
GF 742 
GN 611 
GW 632 . 
GY . 738 
HT 372, 
HM 
HN 708 
HK 454 
HU 216 
IS 274 
IN 404 
ID 510. 
IR 432 
IQ 418 
IE 272 
IL 425 
IT 222 
CI 612 
JM 338 
JP 440 

(Continued) 
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Table C-1. Country Codes (Continued) 


Country Alpha Code Numeric Code 
JORDAN (Hashemite Kingdom of) JO 416 
KAMPUCHEA, DEMOCRATIC KH 456 
KENYA (Republic of) . KE 639 
KIRIBATI KI 
KOREA (Democratic People's Republic of) KP 467 
KOREA (Republic of) KR 450 
KUWAIT (State of) KW 419 
LAO PEOPLE'S DEMOCRATIC REPUBLIC LA 457 
LEBANON LB 415 
LESOTHO (Kingdom of) LS 651 
LIBERIA (Republic of) LR 618 
LIBYA (Socialist People's Libyan Arab Jamahiriya) LY 606 
LIECHTENSTEIN (Principality of) LI 
LUXEMBOURG (Grand Duchy of) LU 270 
MACAO MO 455 
MADAGASCAR (Democratic Republic of) MG 646 
MALAWI MW 650 
MALAYSIA MY 502 
MALDIVES (Republic of) MV 472 
MALI (Republic of) ML 610 
MALTA MT 278 
MARSHALL ISLANDS (Republic of) MH 
MARTINIQUE ; MQ 
MAURITANIA (Islamic Republic of) MR 609 
MAURITIUS MU 617 
MEXICO MX 334 
MICRONESIA (Federated States of) FM 

(Continued) 
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Country Codes 


Table C-1. Country Codes (Continued) 


Country 
MONACO 


MONGOLIAN PEOPLE'S REPUBLIC 
MONTSERRAT 

MOROCCO (Kingdom of) 
MOZAMBIQUE (People's Republic of) 
NAMIBIA 

NAURU 

NEPAL 

NETHERLANDS 

NETHERLANDS ANTILLES 
NEUTRAL ZONE 

NEW CALEDONIA AND DEPENDENCIES 
NEW HEBRIDES 

NEW ZEALAND 

NICARAGUA 

NIGER (Republic of the) 

NIGERIA (Federal Republic of) 
NIUE 

NORFOLK ISLAND 

NORTHERN MARIANA ISLANDS 
NORWAY 

OMAN (Sultanate of) 

PAKISTAN (Islamic Republic of) 
PALAU 

PANAMA (Republic of) 

PAPUA NEW GUINEA 

PARAGUAY (Republic of) 
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Alpha Code 
MC 


MN 
MS 
MA 
MZ 


NA 


Numeric Code 


212 
428 
354 
604 
643 
649 
536 
429 
204 


362 


546 
541 
530 
710 
614 
621 


242 


422 


410 | 


714 
537 


744 


(Continued) 
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Table C-1. Country Codes (Continued) 


Country 7 Alpha Code Numeric Code 
PERU PE 716 
PHILIPPINES (Republic of) PH 515 
PITCAIRN ISLANDS . PN 
POLAND (People's Republic of) PL 260 
PORTUGAL PT 268 
PUERTO RICO PR 330 
QATAR (State of) QA 427 
REUNION (French Department of) RE . 647 | 
ROMANIA (Socialist Republic of) RO 226 
RWANDA (Republic of) RW 635 
SAINT HELENA SH 
SAINT KITTS AND NEVIS KN 356 
SAINT LUCIA LC 358 
SAINT PIERRE AND MIQUELON PM 308 
SAINT VINCENT AND THE GRENADINES vC 360 
SAMOA, WESTERN WS 549 
SAN MARINO SM 
SAO TOME AND PRINCIPE (Democratic Republic of) ST 626 
SAUDI ARABIA (Kingdom of) SA 420 
SENEGAL (Republic of the) SN 608 
SEYCHELLES SC 633 
SIERRA LEONE | SL 619 
SINGAPORE SG 525 
SOLOMON ISLANDS | SB 540 
SOMALIA DEMOCRATIC REPUBLIC so 637 
SOUTH AFRICA (Republic of) ZA 655 
SPAIN ES 214 
(Continued) 
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Country Codes 


Table C-1. Country Codes (Continued) 


Country Alpha Code Numeric Code 
SRI LANKA (Democratic Socialist Republic of) LK 413 
SUDAN (Democratic Republic of the) SD 634 
SURINAME (Republic of) SR 746 
SVALBARD & JAN MAYEN ISLANDS SJ 
SWAZILAND (Kingdom of) | SZ 653 
SWEDEN , SE 240 
SWITZERLAND (Confederation of) CH 228 
SYRIAN ARAB REPUBLIC — SY 417 
TAIWAN, PROVINCE OF CHINA TW 460 
TANZANIA (United Republic of) TZ 640 
THAILAND TH 520 
TOGOLESE REPUBLIC TG 615 
TOKELAU TK 
TONGA TO 539 
TRINIDAD AND TOBAGO TT 84 
~ TUNISIA TN 605 
TURKEY TR 286 
TURKS AND CAICOS ISLANDS TC 376 
TUVALU TV 
UGANDA (Republic of) UG 641 
UKRAINIAN SSR | UA 250 
UNION OF SOVIET SOCIALIST REPUBLICS SU 250 
UNITED ARAB EMIRATES AE 424 
UNITED ARAB EMIRATES (Abu Dhabi) — AE 430 
UNITED ARAB EMIRATES (Dubai) AE 431 
UNITED KINGDOM OF GREAT BRITAIN AND GB 234 or 235 


NORTHERN IRELAND 
(Continued) 
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Country Codes 


Table C-1. Country Codes (Continued) 


Country Alpha Code Numeric Code 
UNITED STATES OF AMERICA US 310 to 316 
UNITED STATES MINOR OUTLYING ISLANDS UM 

UPPER VOLTA HV 

URUGDAY (Oriental Republic of) UY 748 
VANUATU . VU 

VATICAN CITY STATE VA 

VENEZUELA (Republic of) VE 734 

VIET NAM (Socialist Republic of) VN 452 
VIRGIN ISLANDS (British) VG 348 
VIRGIN ISLANDS (United States) VI 332 
WALLIS AND FUTUNA ISLANDS WF 543 
WESTERN SAHARA EH 

YEMEN (Arab Republic) YE 421 
YEMEN (People's Democratic Republic of) YD 423 
YUGOSLAVIA (Socialist Republic of) YU 220 
ZAIRE (Republic of) ZR ; 630 
ZAMBIA (Republic of) . ZM 645 
ZIMBABWE ZW 648 
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Access levels 


Index 


Configuration interrelationships 


A 


Access levels 2-6 
ACTIVATE _AUTO_FORWARDING 
subcommand 4-45 
ACTIVATE _MAIL_GATEWAY command 
Description 4-19 
Installation procedure 3-14 
ACTIVATE _MAILVE command 
Configuration example 2-14, 21, 23, 
25 
Configuration procedure 2-13, 18 
Description 4-20 
File conversion 4-12 
File restoration 4-7 
Installation 2-2, 5 
Output queue 2-32 
ACTIVATE NTF command 3-22 
ACTIVATE __XTF command 2-19, 22 
Active message transfer agent 2-32 
ADD _ADDRESS _LIST 
subcommand 5-60 
ADD_ADDRESS subcommand 
CHADL and CREDL 5-50 
UPDDL 4-48 
ADD __GATEWAY_OUTCALL_ TITLE 
command 3-22 
ADD_LOCAL_NAMES 
subcommand 3-13 
ADD _NON _CDCNET_ADDRESS _ 
PREFIX command 2-17, 21 
ADD_OSI_ADDRESS command 2-17, 
21, 27 
ADD_PERMISSION subcommand 
CHADL, CHAM, CREDL, and 
CREM 5-53 
UPDDL and UPDM 4-51 
Address attributes 1-2 
ADDRESS _DIRECTORY file 4-2 
ADMINISTER _MAIL utility 
Command 5-3 
Defaults 5-2 
Initiation 5-1 
Mail/VE component 1-4 
Mailbox creation 2-12 
Organization definition 2-8 
Route definition 2-10 
Subcommands 5-2, 5 
Termination 65-1 
Validation 2-6 
ADMINISTER _VALIDATIONS 
utility 2-7 
$ADMINISTERED _ FAMILY 
function 5-73 
$ADMINISTERED _USER function 5-74 


60464515 C 


Administrative domain 
INSTALL_MAIL parameter 2-3 
Registered name 1-2 
Administrative management domain 1-2 
Administrator-created mailboxes 2-12 
Alpha codes C-1 
SANY_MAIL function 5-75 
Application interdependencies 2-4 


B 


Backing up directory files 4-4, 23 

BACKUP_PERMANENT_FILES 
utilities 4-4 

BITNet 
DOMAIN _NAMES_FILE 3-3, 5, 10 
extended :nick. entry 3-10 
Gateway installation 3-7, 10 
INSTALL _MAIL_GATEWAY 

command 3-2, 6 : 

Non-BSMTP routing examples 3-32 
Overview 3-1 
Routing examples 3-31 

BITNet Network Information Center 3-7, 
10, 13 


C 


CCITT X.400 Recommendations 1-1 
CDCNET 2-4, 14, 17, 19 
CHANGE _ DISTRIBUTION _ LIST 
subcommand 5-4 
CHANGE_MAILBOX subcommand 5-7 
CHANGE _PROTOCOL_STACK _ 
SUPPORT command 2-18, 21 
CHANGE _USER subcommand 2-7 
COMBINE _UPDATE _LETTERS 
command 
Description 4-21 
Summary 4-14 
UPDATE _REMOTE _ 
ADDRESSES 4-35 
Commands 
ADMINISTER_MAIL 5-3 
Maintenance commands 4-18 
Remote address commands 4-13 
(See Subcommands.) 
COMPRESS _MAIL_DATABASE 
command 2-33 
Configuration 
Multihosts 2-2, 4 
Preview 2-1 | 
Single system 2-2 
Configuration files 4-2 
Configuration interrelationships 2-16, 27 
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Configuration procedures 


Configuration procedures 
Mail/VE gateway 3-4 
Non-NOS/VE systems 2-17 
NOS/VE systems 2-13, 17 
CONVERT_MAILVE _DATABASE 
command 
Conversion procedure 4-10 
Description 4-23 
Country 
Codes 2-3; C-1 
INSTALL_MAIL parameter 2-3 
Registered name 1-2. . 
CREATE _CATALOG _PERMIT 
command 2-7 
CREATE COMMAND _LIST_ENTRY 
command 3-12 
CREATE _DISTRIBUTION _LIST 
subcommand 
Description 5-9 
Usage 4-13 
CREATE _MAILBOX subcommand 
Description 5-11 
Usage 2-12; 4-13 
CREATE _ORGANIZATION 
subcommand 
Configuration example 2-15, 22, 24, 
26 
Configuration interrelationships 2-16, 
30 
Configuration procedure 2-13, 19 
Description 5-12 
Installation 2-2 
Mail/VE gateway 3-2, 14, 15 
Usage 2-8 
CREATE _ROUTE subcommand 
Configuration example 2-15, 22, 24, 
26 
Configuration interrelationships 2-16, 
27, 29, 30 
Configuration procedure 2-13, 19 
Description 5-13 
Installation 2-2 
Mail/VE gateway 3-2, 14, 15 
Usage 2-10 


D 


Damaged files 2-32 
Database files 4-2 
DEACTIVATE _MAIL_GATEWAY 
command 4-24 
DEACTIVATE_MAILVE command 4-25 
$DEFAULT_MAILBOX function 5-78 
Default routing 3-7, 9, 19 
Deferred messages 2-32 
DEFINE _DEFAULT_GATEWAY_ 
ADDRESS subcommand 
Description 5-15 
Gateway procedure 3-13, 15 
DEFINE _NP_GATEWAY command 3-22 
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Domains 


DEFINE _QTFS subcommand 
Configuration example 2-14, 21, 23, 
25 
Configuration interrelationships 2-16, 
29, 30 
Defining organizations 2-8; 3-2 
Defining routes 2-10; 3-2 
DELETE ADDRESS subcommand 5-55 
DELETE _DISTRIBUTION _LIST 
subcommand 5-16 
DELETE _LETTER subcommand 5-18 
DELETE _MAILBOX subcommand 5-19 
DELETE _ORGANIZATION 
subcommand 5-21 
DELETE _PERMISSION 
subcommand 5-58 
DELETE_ROUTE subcommand 5-22 
DELETE _USER subcommand 5-23 
DETACH _FILE command 4-6, 10 
Directory files 
Backup 4-4, 5 
Exclusive access 4-6, 9 
Mail/VE components 1-4 
Mail/VE gateway 1-4 
Restoration 4-4, 6 
Summary 1-4; 4-2 
Version 1 conversion 4-9 
DISPLAY_ADDRESS _ LIST 
subcommand 5-60 
DISPLAY_ATTRIBUTES 
subcommand 5-61 
DISPLAY_DEFAULT_GATEWAY_ 
ADDRESS subcommand 5-24 
DISPLAY_DISTRIBUTION _ LIST 
subcommand 5-25 
DISPLAY_MAILBOX subcommand 65-28 
DISPLAY_ORGANIZATIONS 
subcommand 5-30 
DISPLAY_PERMISSIONS 
subcommand 5-62 
DISPLAY_ROUTES subcommand 5-32 
DISPLAY_USERS subcommand 5-34 
Distributed database files 4-3 
$DISTRIBUTION _LIST_ATTRIBUTE 
function 5-79 
DISTRIBUTION _LIST_CONTENTS 
file 4-2 
Distribution list update 
subcommands 4-44 
Domain field 3-16 
DOMAIN NAMES file 3-7, 10 
DOMAIN _NAMES_FILE 
Backup 4-3 
Configuration file 4-2 
Default name 3-1 
Entry format 3-16 
Example 3-27 
Maintenance 3-1, 3, 5 
Domain-wide directory 
Maintenance 4-13 
Domains 1-2 
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Editing files 


E 


Editing files 2-7; 4-8 
Electronic mail system 1-1 
EMAIL utility 1-4; 2-6 | 
END _ADMINISTER _MAIL 
subcommand . 
Description 5-36 
Mailbox creation 2-12 
Organization definition 2-9 
Route definition 2-10 
END CHANGE _DISTRIBUTION _LIST 
subcommand 5-63 
END CHANGE _MAILBOX 
subcommand 5-64 
END _CREATE _ DISTRIBUTION _LIST 
subcommand 5-65 
END_CREATE _MAILBOX 
subcommand 5-66 
-END _ MANAGE _MAIL_ DIRECTORY 
subcommand 
Description 4-37 
Domain-wide directory 4-15 
File backup 4-5 
File restoration 4-7 
END_UPDATE _ DISTRIBUTION _LIST 
subcommand 4-53 
END _UPDATE _MAILBOX 
subcommand 4-54 _ 
ENTITY_DIRECTORY file 4-2 
Entry format 3-16 
Epilog files 2-5, 17; 3-14 
Examples 
Mail/VE gateway 3-4 
Mail/VE gateway routing 3-26 
Using NOS/VE and other X.400 
systems 2-19 
Using NOS/VE systems 2-14 


F 

File editing 4-8 

Files 
Configuration 4-2 
Damaged 2-32 
Database 42 
Editing 2-7; 4-8 
(See Directory files.) 

Format field 3-18 

Functions 5-72 


G 


GENERATE _ADDRESS_UPDATES 
command 

Description 4-26 

Summary 4-14 
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Intradomain attributes 


GENERATE _DIRECTORY_UPDATE 
subcommand 
Description 4-38 
Domain-wide directory 4-15 
File Backup 4-5 
File Conversion 4-11 
GENERATE _REMOTE _UPDATES 
command 
Description 4-27 
Summary 4-14 
UPDATE _REMOTE _ 
ADDRESSES 4-35 
Global addresses 1-2 
Glossary A-1 


I 


$IDENTITY function 5-84 
INCLUDE _FILE command 3-12; 4-7, 12 
INSTALL MAIL command 
Configuration example 2-14, 21, 23, 
25 
Configuration interrelationships 2-16, 
28, 29, 30 
Configuration procedure 2-13, 17 
Description 4-28 
Installation 2-2 
Parameters 2-3 
INSTALL _MAIL_ GATEWAY command 
Address information summary 3-2 
Description 4-30 
Example 3-12 
Naming conventions 3-12 
INSTALL_SOFTWARE command 2-5 
INSTALL __X400 TRANSFER _ FACILITY 
command 
Configuration example 2-21 
Configuration procedure 2-17 
Interrelationships 2-28, 29 
XTF usage 2-4 
Installation 
Mail/VE 2-5 
Mail/VE gateway 3-4 
Overview 2-1 
Interdomain attributes 1-2 
Internet 
DOMAIN _NAMES_FILE 3-3, 8 
Gateway installation 3-10, 12 
INSTALL _MAIL_GATEWAY 
' command 3-2, 9 
Overview 3-1 
Routing examples 3-30 
Workstations 3-9 
internet. entries 
BITNet communications 3-5, 10 
Description 3-16, 25 
Internet communications 3-6, 10 
Intradomain attributes 1-3 
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$LETTER_ATTRIBUTE function 


L 


$LETTER _ATTRIBUTE function 5-86 
$LETTER function 5-85 
$LETTER_LIST function 5-89 
LIST_MAIL subcommand 5-37 

Local addresses 1-3. 
LOOKUP_ADDRESS subcommand 5-41 
Loosely Coupled Network (See LCN.) 


M 


MAIL _INSTALLATION _ TABLE 
file 4-2, 3 
Mail relay 3-1 
Mail/VE 
Administrators 
Configuration procedure 2-13, 18 
Description 2-6 
Mail/VE gateway tasks 3-1 
Components 1-4 
Configuration 2-13, 17 
Directory files 4-2 
Directory management 4-18 
Installation 2-2, 5; 3-15 
Maintenance 4-1 
Maintenance commands 4-18 
Organizations 2-8 
Overview 1-1 
Routes 2-8 
Validation fields 2-6 
X.400 recommendations 1-2 
Mail/VE gateway 
Description 3-1 
Installation procedure 3-4, 12 
Mail/VE component 1-4 
Manual references B-17 
Multihosts 3-15 
Organization definition 3-2 
Planning 2-2, 13, 19 
Route definition 3-2 
Mail/VE software 1-4 
Mail/VE validation field 2-6 
Mail/VE Version 1 4-9 
$MAILBOX _ATTRIBUTE function 5-91 
$MAILBOX function 5-90 
Mailboxes 
Creation 2-12, 19 
Update subcommands 4-44 
MAILVE ADMINISTRATION field 2-6 
MAILVE _ADMINISTRATION 
validation 4-13 
MAILVE_CONFIGURATION file 4-2, 3 
MAILVE _DISTRIBUTION _LIST_LIMIT 
field 2-6 
$MAILVE __INSTALLATION 
function 5-94 
MAILVE __MAILBOX_LIMIT field 2-6 
MAILVE _RETENTION _LIMIT field 2-6 
$MAILVE_USERS function 5-95 
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OSFS$BUILTIN LIBRARY 


Maintenance 
Command library 1-4; 2-6 
Commands 4-18 
Ongoing activities 2-32 
Procedures 4-1 
Reference information 4-1 
MANAGE _APPLICATIONS _ 
DEFINITIONS subcommand 2-14, 21, 
23, 25 
MANAGE _MAIL_DATABASE 
command 2-32 
MANAGE _MAIL_DIRECTORY utility 
Command 4-32 
Domain-wide directory 4-13 
File backup 4-4, 5 
File conversion 4-11 
File restoration 4-4, 6 
Subcommands 4-33 
MANAGE _NTF_LOCAL_NAMES 
command 3-13 
MANAGE _USER_FIELDS 
subcommand 2-7 
Management domains 1-2 
Manual references B-1 
Message handling systems 1-1 
Message transfer agents (MTAs) 1-3 
MTA name 
INSTALL_MAIL parameter 2-3 
Message transfer agent 1-3 
Title relationship 2-8, 15, 16 
Multihosts 2-2, 4; 3-15 
MVF$ELECTRONIC _MAIL_ DATABASE 
file 4-3 


N 


nick. entries 
BITNet communications 3-5, 10 
Extended entry 3-19 
Extensions 3-16, 18 
Internet communications 3-8, 10 
Internet workstations 3-9 
Standard entry 3-16 | 
NOS/VE administrators 2-7 
NOS/VE system configuration 2-13, 17 
NTF 
Extended :nick. entry 3-22 
Routing parameters 3-23 
Numeric codes C-1 


O 


Organization name 1-3 
Organization unit 1-3 
Organizations 
Definition 2-8 
_ Local address attributes 1-3 — 
Mail/VE gateway 3-2 
Procedure 2-9 
OSF$BUILTIN LIBRARY 2-19 
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OSI addresses 


OSI addresses 2-17 

OSI protocol stack 2-18 

Output queue activity 2-32 

Overview 1-1 

$OWNED _DISTRIBUTION _LISTS 
function 5-96 


SOWNED_MAILBOXES function 5-97 


P 


Periods 3-17 
PERMISSION __DIRECTORY file 4-3 
Permissions 2-7 
Permits 4-6, 9, 11 
Personal name 1-3 
Planning 2-2, 4 
Postmaster (See default routing.) 
Private domain 
INSTALL_MAIL parameter 2-3 
Registered name 1-2 
Private management domain 1-2 
Prolog files 2-5, 17; 3-14 
Protocol stacks 2-18 


Q 


QTF 
Configuration procedure 2-13, 17 
Extended :nick. entry 3-21 
Interdependencies 2-4 
Route entry 2-10 
Queue File Transfer Facility (See 
QTF.) 


R 


Registered names 1-2 

Rejection notices 3-7, 9, 19 

Related manuals B-1 

Remote addresses 4-13 

Repairing damaged database files 2-32 
RESTORE _PERMANENT_FILES 
utilities 4-4 

Restoring directory files 4-4, 6 
RETAIN _LETTER subcommand 5-44 
RFC822 addresses 3-24, 25 

RFC822 protocols 3-1 

ROUTE _DIRECTORY file 4-3 
Routes 2-10; 3-2 

Routing examples 3-26 

Routing field 3-18 


S 


SELECT_LETTER subcommand 5-46 
SELECT_USER subcommand 5-47 
SEND_ADDRESS_UPDATES command 
Description 4-33 
Summary 4-14 


60464515 C 


USER_DIRECTORY file 


SET_ATTRIBUTES 
SET_ATTRIBUTES subcommand 
CHADL and CREDL 5-67 
CHAM and CREM _ 5-70 
Domain-wide directory 4-13 
UPDDL 455 
UPDM 4-57 
SMTP 3-8, 18, 20 
Subcommands 
ADMINISTER_ MAIL 5-3 
Distribution list subutility 4-33 
Distribution list update 4-44 
Mailbox subutility 5-48 
Mailbox update 4-44 
MANAGE __MAIL_DIRECTORY 4-36 
Subdomain field 3-17 
System interrupt 2-32 
$SYSTEM.MAILVE _ 
V2.MAIL.DIRECTORY_ BACKUP 
file 4-7 
$SYSTEM.MAILVE _ 
V2.MAINTENANCE.COMMAND _. 
LIBRARY 4-18 
$SYSTEM.OSF$BUILTIN _ 
LIBRARY 4-18 
$SYSTEM.OSF$COMMAND _LIBRARY 
file 2-34 
$SYSTEM.TDU. TERMINAL_ 
DEFINITIONS file 2-34 


T 


Terminal definitions 2-33 
TITLE parameter 2-8 


U 


UPDATE _ DISTRIBUTION _ LIST 
subcommand 
Description 4-39 
File editing 4-8 
UPDATE _MAILBOX subcommand 
Description 4-40 
File editing 4-8 
UPDATE _ORGANIZATION 
subcommand 
Description 4-41 
File editing 4-8 
UPDATE _REMOTE _ADDRESSES 
command 
Description 4-35 
Summary 4-14 
UPDATE ROUTE subcommand 4-42 
Update subcommand files 
File editing 4-8 
Generating 4-4 
USE _NTF_UTILITIES command 3- 13 
User-created mailboxes 2-12 
User database files 2-33 
USER _DIRECTORY file 4-3 
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Utility defaults :x400. entries 


Utility defaults 5-2, 94 Routing examples 3-30 
: :x400 entries 3-24 
X.400 networks 
V 7 DOMAIN _NAMES _FILE creation 3-3 
Validation fields 2:6 INSTALL_MAIL_GATEWAY 
Version 1 4-9 command 3-2 
VT220 terminal 2-33 X.400 protocols 3-1, 2 


X.400 recommendations 1-1 
X.400 Transfer Facility (See XTF.) 


W XMAILER NAMES file 3-7, 10 
: XTF 2-4, 10, 17 
Wildcard character 4-23, 52 XTF configuration file 2-18, 21; 4-4 
Workstations 3-9 -x400. entries 
WRITE _LETTER utility 2-32 BITNet communications 3-5, 10 
Description 3-16, 24 
X Internet communications 3-8, 10 


X.400 addresses 
Destination 1-2 
Global 1-2 
Local 1-3 
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We would like your comments on this manual to help us improve it. Please take a few minutes to fill out 
this form. 


Who are you? How do you use this manual? 

[] Manager (] As an overview 

[] Systems analyst or programmer [] To learn the product or system 

(] Applications programmer : [J For comprehensive reference 

C[] Operator [J For quick look-up 

[-] Other soe Saks ae pie Bea. “i OUMCR 2.02 ae. Ss Pee ee Nas he ee : 


What programming languages do you use? —_— 


How do you like this manual? Answer the questions that apply. 

Yes Somewhat No 

Does it tell you what you need to know about the topic? 

Is the technical information accurate? 

Is it easy to understand? 

Is the order of topics logical? 

Can you easily find what you want? 

Are there enough examples? 

Are the examples helpful? ({] Too simple? [] Too complex?) 
Do the illustrations help you? 

Is the manual easy to read (print size, page layout, and so on)? 
Do you use this manual frequently? 
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OOOOOO00000 


Comments? If applicable, note page and paragraph. Use other side ifneeded. 


Check here if you want a reply: [] 


’ Name Company 
Address Date 
Phone 


Please send program listing and output if applicable to your comment. 


Command, Subcommand, and Function 
Index 


ACTIVATE _AUTO_FORWARDING ............c.cccccececcecevueeeees Sere eee 4-45 
ACTIVATE MAIL -GATEWAY os o.656 002 bane cau sceessasehdbeys bovis sabvasewecws 4-19 
WOTIVATES MALLY 26nd cue ustet ie ie Dice stwnlae ted Sakae aa ay ee ol nee ees 4-20 
ADD_ADDRESS (CHADL and CREDL) .............cccecececeeceeuceeeeeueucueus 5-50 
ADD: ADDRESS (UPDDL) iii ioic th wee een reek bee was SOE hase clahaes 4-48 
ADD_PERMISSION (CHADL, CHAM, CREDL, CHEM) ..................0.0eeeee 5-53 
ADD _PERMISSION (UPDDL and UPDM))............. 0. cc cece cece cece eee e eens 4-51 
ADMINISTER 2 MAIG + g2-0%:0s.2-00dcesnatenduunraeiudeninbiae aduwncebietan bend ugenttes 5-3 
$ADMINISTERED _FAMILY ......... 000.0 ccc c cece cece ceeceeeceeeucueuveeeeenes 5-73 
$ADMINISTERED_USER ..........0. 0 ccc ce cccccceccucucceevcucuceucucuseeenenes 5-74 
C4. Ba BN ae gO a eR gee RN ae ee aE 5-75 
CHANGE _DISTRIBUTION _LIST ............. cc cececcdeececeucececeveeencucececs 5-4 
CHANGE: “MAUL BOX c.ch econ nas tern svradscuas het emwline ud eeal a butarwoatenucutoe 5-7 
COMBINE 2UPDATE LETTERS 5 2265042 ios-crnen ced waannwenaweeedeasaesey | 4-21 
CONVERT_MAILVE _DATEBASE ............ 00. cccececcccececcceucucuceeenenees 4-23 
CREATE - DISTRIBUTION... UIST? sec diceydhcta kid idee hs bike elena chad eawndenven neues 5-9 
CREATE: MAIEBOX 46 osc) busch nad awnidaen tuscany hinges nace toetae es 5-11 
CREATE “ORGANIZATION » 6.3.2ce5.454 yc dd 55 560058 ios Soa hee bet ARORA Oe 5-12 
CREATE ROU TES i ceuutere onl olin os Sates wince aeioa dient ad naat ata bates role 5-13 
DEACTIVATE __MAIL_GATEWAY .........0. 0.0 cccceecccecececcecvcuceceveteneees 4-24 
DEACTIVATE © MALINE tics Shins ds tre ataeuet wh cade temarnct PaO ene hoes wee inaa els 4-25 
“SDESAU LE 2 MAIEBOX ic oho Gupte atone me bdied wee nies Miva hanawGss Gon tess 5-78 
DEFINE __DEFAULT_MAIL_ADDRESS ..............cccececececeecececucucuceees 5-15 
|} OF Od RD 50 > mV 5-55 
DELETE DISTRIBUTION LIST 453 ives beak oe deoeanedadaeeicnyeaeedaeaporwe ee 5-16 
DEDE EE SUR TPE R fii avavare cu ducnud epmknan bedaksns taaonteteuaesseecuaiane 5-18 
DELETE MAILBOK. 2: .d.c0cesesnclen Satna ean ohn ee el ak eh iden a aes 5-19 
DELETE ORGANIZATION 22 xc sevens dan bay osu ala eret ined ean as ace tendaye eae ree: 5-21 
DELETE PERMISSION -cccu.cscy sea neeeos sation has hecdna Seige latin neve MA cad 5-58 
|B) 0) BOY BOM 2 10) OL i Oa ea ea ee oO A OP 5-22 
1D) OH 8d OER OS) 0: Se mae ene OR eae 5-23 
DISPLAY_ADDRESS _LIST .......... 0. cc cccecececcecucucueuececucucueucucucaens 5-60 
DISPLAY 2ATTRIBU TES i224 ooicns os been ee ave ak nd dO ee eee 5-61 
DISPLAY_DEFAULT_GATEWAY_ADDRESS .............. cece ceecececececuceees 5-24 
DISPLAY_DISTRIBUTION _LIST .......... 00. cece cece cece cece eneaeeeeveeenenaes 5-25 
DISPLAY MAILBOX 25g cette oa ae ooo acian baiiw bb) wl Dan oads Se eee 5-28 
DISPLAY “ORGANIZATIONS g5 onc tu doen vayeugae tate te munities Raw deb eeceneuess 5-30 
DISPLAY_PERMISSIONS ...............005: pnicha Daas teeta tendo eke aaaeeeatn beats 5-58 
DISPLAY ROUTES winter sio tele ict ye cect pineal torekd era tk we eeewa neeberes 5-32 
DISPLAY USERS 26sec) ol niet len eect eeu ak ass ws paeee saute wiaceiec eae 5-34 
$DISTRIBUTION _LIST_ATTRIBUTE ......... 0.0. ccccccccccecececuctcecececucucs 5-79 
END: ADMINISTERS MAUD lei? eS qarhun dp vr ease aed atiuy dahon ie iaa deeibad 5-36 
END_CHANGE _DISTRIBUTION _LIST 1.0.00... 00. ccc cece cece eee ceeeaeeneeees 5-63 
END CHANGE MAILBOX vos. cocec Geta oiwavig shade budadokeahesoueaweutsdeeses 5-64 


END CREATE _DISTRIBUTION _LIST ..... 00... cece cece eee eet en eee 5-65 


END “CREATE - MAILBOX cc sedis idicanuiecwSscaunekeadate tuconsodais eon eet ws 5-66 
END_MANAGE_MAIL_DIRECTORY .............. cee cee eee cecceeeeeaeeseeeeees 4-37 
END _UPDATE_DISTRIBUTION _LIST ........... seh ri Th fo cae asia ne aE 4-53 
END-JOPDATE = MAILBOX Sscx 005 wasn acack aatancee Od oe aeaca vata edieeue a8 4-54 
GENERATE _ADDRESS_UPDATES ............ 0. cece ec ee cee ceceeeeeeeeeeeeneees 4-26 
_ GENERATE _DIRECTORY_UPDATE ...........0. 0c cece cee c eee eee eee tnee nena es 4-38 
GENERATE __REMOTE_UPDATES ............. cc cece cece cece cece ence teeeeenees 4-27 
SIDEN TIDY aes cotedlea Lanne wie easaan pie orb awasnins ieamncatan die beled seein 5-84 
PN STAG ic ees cr on tec ee gt ace added x nana letes uo whet aud Gatdia me oekes le tise ise vars 4-28 
INSTALL_MAIL_GATEWAY ............. b Sula tec snp peRaR eat nam eee ape eee ae 4-30 
BS TBR oo ets ate ese caae a eect een elvan oie anes Badd eee 5-85 
SLETTER ATERIB ULE: 45 odio aod bales bd Sk Ral be aie wd Pa eke es 5-86 
SUETTER ~ UIST: fui ces ds cundas ewan diteeeeinas Ih ssei dh hasnt Sauna eanne ln, mcgareeuiead wed 5-89 
TAST MAIL, ve che utehamerteemcot ei ase sie wes Lamidaccun esas eee sua Sereomede 5-37 
LOOKUP “ADDRESS 1.525 ce nweten oe sites deine Bi cl aad Gc oe awe 5-41 
SMAI BON oles cactn deo etas: utancw nine rene ke ea iee tiers bah oat a eee teas 5-90 
$MAILBOX _ATTRIBUTE ..............c cc ceeeececececveeeeevees tL ss a ohh eee Vana 5-91 
SMAILVE 7 INSTALLATION: os duiccusdouiucd din ls OhMcose tan bexsanae dune teenaeeees 5-94 
SM ATEV Bs USER sexu hye lets tl ach ha eam ehaetnnaduss bac aitdin wate hetate bee wen uelaa ai: 5-95 
MANAGE _MAIL_DIRECTORY .............. ccc cececcececcucececeeeceueucuceenns 4-32 
$OWNED _DISTRIBUTION _LISTS ........... 0. cece cece cece ceececucncueucucuens 5-96 
SOWNED “MAILBOX 5 oie ei ee le udice a au wleatu due duuietihehnmas ees nae 5-97 
RETAIN JP TER e656 5 ces tixs Saeco g ed She Ok Se BR a eae aoa ade 5-44 
SEURCT CLETPER 3 iets oosaeetawio nse ta tactics suc bed rouge anaes 5-46 
SREB OT ISR antic aS occ ecw eacedtutiia a ae abel oe ates nee tele eles Oe Ro eee ten athe 5-47 
SEND_ADDRESS_UPDATES ........... 0. cece cece cece cee ceeeeencueusnensuceenes 4-33 
SET_ATTRIBUTES (CHADL and CREDL) ............... cc ces ece cece ee eeeeeecees 5-67 
SET_ATTRIBUTES (CHAM and CHEM) .................ccececcececeeeeecveveece 5-70 
SET_ATTRIBUTES (UPDDL) .............cccccccccececcecececeacececuevateeneus 4-55 
SET_ATTRIBUTES (UPDM) .............0-ececececeencececs Sy ea eee ee ee ee 4-57 
UPDATE _DISTRIBUTION _LIST ......... 0. cc cece cece cece cee eeecucneeueucuenees 4-39 
UPDATE MAILBOX 4 cseicbae nos cera cca boa h ae nel Seadedaea sheute iaiaaieds 4-40 
UPDATE ORGANIZATION osc ceksienidin chee ee a 4-41 
UPDATE _REMOTE_ADDRESSES .............. cece cece cececeeeceeeeeueesencuces 4-18 


UPDATE: LROUTE: tcc2s634heevedeeeniae ess Airis cin eee owosa nd bre eels ease ait 4-42 
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